11 2018-01-30 07:55:33 SunilMohanAdapa Update GitHub links with Salsa 10 2017-03-06 23:17:08 JamesValleroy add note 9 2016-10-13 21:49:06 David Jones Added infromation about connecting to the FBX using ssh over Tor 8 2016-10-13 21:09:31 David Jones Added information about admin account for first log in to Plinth 7 2016-09-05 09:42:36 ElVirolo Removing my previous contribution, as info already present in original version. 6 2016-09-05 09:39:05 ElVirolo 5 2016-09-05 09:26:15 ElVirolo Added "Users created via Plinth" paragraph 4 2015-12-21 19:42:10 JamesValleroy update default account 3 2015-12-21 19:33:56 JamesValleroy fix outline level 2 2015-12-15 19:31:18 PhilippeBaret Added definition title 1 2015-09-16 16:22:37 SunilMohanAdapa New manual page for secure shell access

FreedomBox runs openssh-server server by default allowing remote logins from all interfaces. If your hardware device is connected to a monitor and a keyboard, you may login directly as well. Regular operation of FreedomBox does not require you to use the shell. However, some tasks or identifying a problem may require you to login to a shell.

When creating an account in Plinth for the first time, this user will automatically have administrator capabilities. Admin users are able to log in using ssh (see Logging In below) and have superuser privileges via sudo.

Note: If you can access Plinth, then you don't need to do this. You can use the user account created in Plinth to connect to SSH. The pre-built FreedomBox images have a default user account called "fbx". However the password is not set for this account, so it will not be possible to log in with this account by default. There is a script included in the freedom-maker program, that will allow you to set the password for this account, if it is needed. To set a password for the "fbx" user: 1. Decompress the image file. 2. Get a copy of freedom-maker from . 3. Run sudo ./bin/passwd-in-image <image-file> fbx. 4. Copy the image file to SD card and boot device as normal. The "fbx" user also has superuser privileges via sudo.

To login via SSH, to your FreedomBox: Replace fbx with the name of the user you wish to login as. freedombox should be replaced with the hostname or IP address of you FreedomBox device as found in the Quick Start process. fbx is the default user present on FreedomBox with superuser privileges. Any other user created using Plinth and belonging to the group admin will be able to login. The root account has no password set and will not be able to login. Access will be denied to all other users. fbx and users in admin group will also be able to login on the terminal directly. Other users will be denied access. If you repeatedly try to login as a user and fail, you will be blocked from logging in for some time. This is due to libpam-abl package that FreedomBox installs by default. To control this behavior consult libpam-abl documentation.

If in Plinth you have enabled hidden services via Tor, you can access your FreedomBox using ssh over Tor. On a GNU/Linux computer, install netcat-openbsd. Edit ~/.ssh/config to enable connections over Tor. Add the following: Replace USERNAME with, e.g., an admin username (see above). Note that in some cases you may need to replace 9050 with 9150. Now to connect to the FreedomBox, open a terminal and type: Replace USERNAME with, e.g., an admin username, and ADDRESS with the hidden service address for your FreedomBox.

After logging in, if you want to become the superuser for performing administrative activities: Make a habit of logging in as root only when you need to. If you aren't logged in as root, you can't accidentally break everything.

To change the password of a user managed by Plinth, use the change password page. However, the fbx default user is not managed by Plinth and its password cannot be changed in the web interface. To change password on the terminal, log in to your FreedomBox as the user whose password you want to change. Then, run the following command: This will ask you for your current password before giving you the opportunity to set a new one. Information Support Work Space Reports Promote Overview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog