-
Notifications
You must be signed in to change notification settings - Fork 145
Get your environment done
You are trying to run abacus either on your computer or a remote server accessed by ssh.
Use ssh.
And, of course that's not all of this part. We strongly recommend using public key authentication to avoid entering password all the time. This takes two steps:
- generate a key:
ssh-keygen, and - put the key onto the server:
ssh-copy-id user@host. This is the very last time you enter your password.
For Windows users, follow Install OpenSSH guide to install the ssh and ssh-keygen tools. There is not a ssh-copy-id command on Windows, so you have to do it manually. Try type $env:USERPROFILE\.ssh\id_rsa.pub | ssh user@host "cat >> .ssh/authorized_keys". Read the origin blog post for further information.
Using Container in VS Code, regardless of the platform you are on.
- Click "Clone Repositry" in VS Code Explore page on side bar (usually left-top), and enter the address of abacus repositry.
- Install requirements and compile abacus, or
- Follow the instruction on the notification area. This will clone a docker image containing all of the requirements.
The default shell is bash in most cases. We recomment replacing it with Z shell by the Oh My Zsh tool.
Another choice is fish shell. It comes with an user-friendly interface, however, and some compatiability issues - still worth trying.
The best editor to use for remote developing. We'll discuss it on a dedicated page.
Since abacus does not support Windows officially, use Windows Subsystem for Linux as an alternative: just follow the best practice guide.
WSL2 has huge improvements than WSL1, so be sure you are installing under WSL2 configuration. By wsl --install you will get the proper installation. We suggest you install Linux distributions (e.g. Ubuntu) from Microsoft Store, rather than from Powershell commandline interface, as the former method is more stable.
Please be aware that the file system between WSL and Windows partially shares.
Stop using the annoying cmd! Powershell improves little. Try Windows Terminal for a better shell experience under Windows. You can launch WSL simply in a new tab.