Thorg Initial Startup
On initial startup, Thorg presents a setup wizard that requests the following information. Expand the sections below to learn more about each item.
Thorg Username
Set/Modify
Set during Thorg setup. Can be modified through thorg.startupSetup.thorgUsername - VSCode Config.
Use case
The primary use case in V1 is separating Visit History files when users decide to share visit history files between multiple users.
Machine Name
What is it?
machineName: A name for your machine that is unique under your chosen username.
Valid examples: [macos-laptop-1, windows-desktop, machine-1]
Why it exists?
Primary use case: to disambiguate changes made on different machines while using the same username. This prevents unnecessary Git merge conflicts in data such as Visit History. Thorg segments the files it creates using the machineName you provide.
Avoid sharing this value across machines
Do NOT share or re-use this value across machines. Sharing it will cause Git merge conflicts in your Visit History.
Example scenario
Starting scenario
You have a laptop and desktop that you use. Valid values for machineName would be "laptop" and "desktop" respectively.
IF you got a 2nd laptop for prolonged usage
If you need a 2nd laptop while retaining your previous laptop, a valid value for machineName on the brand new laptop would be "laptop2".
IF you got a 2nd laptop without overlap in usage
If you sold your laptop and don't plan any overlap in usage between the old and new laptop, it's OK to give the new laptop the designation "laptop" for machineName.
When do you specify it?
You will specify it during the initial start up of Thorg.
Where is it stored?
Whether to auto-install Java (JRE)
On startup, you'll be asked whether to auto-install the JRE.
The recommendation is to let Thorg auto-install a JRE. This ensures you have a stable path to the JRE that thorgServer can run on.
If you decide to provide your own path to the JRE, that's fine too. However, if the path changes (for example, if you update the JRE and it's installed to a slightly different path), Thorg will ask you to re-provide the path on its next startup.
Backlinks