NAME¶

freedombox-cmd - command line utility to perform FreedomBox operations

SYNOPSIS¶

freedombox-cmd [-h, --help] {module} {action} [--no-args]

DESCRIPTION¶

FreedomBox is a community project to develop, design and promote personal servers running free software for private, personal communications. It is a networking appliance designed to allow interfacing with the rest of the Internet under conditions of protected privacy and data security. It hosts applications such as blog, wiki, website, social network, email, web proxy and a Tor relay on a device that can replace a wireless router so that data stays with the users.

freedombox-cmd is a command line interface to some of the operations performed by FreedomBox. It is typically not needed by the end users who use FreedomBox's web interface. The command may be used in some cases while debugging problems, especially where the web interface is not accessible or when a piece of functionality that is not provided in the web interface needs to be triggered.

The command is simply a client to the FreedomBox's privileged daemon and relays user's request to it. It waits for the request to complete and prints the output of the operation or an error message collected form the daemon. The daemon only allows connections from an pre-allowed list of user accounts. So, be sure to run the command as 'root' superuser.

OPTIONS¶

module

action

--no-args

--help

EXAMPLES¶

Example 1. Re-run FreedomBox network setup

$ sudo freedombox-cmd networks setup --no-args

When FreedomBox starts for the first time, it will setup Network Manager connections suitable for the hardware found. If you wish to re-create these connections at a later time, you can re-run setup for the Networks app using the web interface or run this command on a terminal.

Example 2. Delete a user account from LDAP database

$ echo '{"args": ["USERNAME", "AUTH_USER", "AUTH_PASSWORD"], "kwargs": {}}' | sudo freedombox-cmd users remove_user

USERNAME is the name of the user account that must be removed. AUTH_USER is name of the user account that is authorizing this operation. AUTH_PASSWORD is the password for user account that is authorizing this operation. This operation may be needed if FreedomBox's sqlite3 database is wiped, removing the user accounts in the database but the corresponding entries from LDAP database are not removed. A new user with that name can't be created until the LDAP account is also removed.

Example 3. Set the logging mode to persistent

$ echo '{"args": ["persistent"], "kwargs": {}}' | sudo freedombox-cmd config set_logging_mode

By default, FreedomBox sets up systemd-journald to 'volatile' logging. This means that logs will not be stored on the disk and will be lost after a reboot. If you are tackling a problem and wish to store the logs persistently, you can change the setting in the web interface or run this command.

BUGS¶

See FreedomBox issue tracker[1] for a full list of known issues and TODO items.

AUTHOR¶

FreedomBox Developers

NOTES¶

1.

FreedomBox issue tracker