Etebase: Difference between revisions
Denperidge (talk | contribs) Added CLI Method, changed global.secret_file comment, fixed NixOS syntax highlighting |
|||
| Line 3: | Line 3: | ||
This is a basic configuration to run the Etebase server: | This is a basic configuration to run the Etebase server: | ||
< | <syntaxhighlight lang="nixos"> | ||
networking.firewall.allowedTCPPorts = [ 443 ]; | networking.firewall.allowedTCPPorts = [ 443 ]; | ||
services = { | services = { | ||
| Line 12: | Line 12: | ||
settings = { | settings = { | ||
global.debug = false; | global.debug = false; | ||
global.secret_file = "/path/to/secret"; # | global.secret_file = "/path/to/secret"; # Needs to be a non-existing filepath, which is writeable by configured user | ||
allowed_hosts.allowed_host1 = "etebase.your.domain"; | allowed_hosts.allowed_host1 = "etebase.your.domain"; | ||
}; | }; | ||
| Line 29: | Line 29: | ||
}; | }; | ||
}; | }; | ||
</ | </syntaxhighlight> | ||
For the server to accept requests from a remote machine {{ic| allowed_host1}} variable should be set as the server's subdomain/domain name and your proxy has to present a {{ic| Host}} header. | For the server to accept requests from a remote machine {{ic| allowed_host1}} variable should be set as the server's subdomain/domain name and your proxy has to present a {{ic| Host}} header. | ||
| Line 39: | Line 39: | ||
To use the Etebase server, the creation of an admin account is required. This requires manual intervention: | To use the Etebase server, the creation of an admin account is required. This requires manual intervention: | ||
==== CLI Method ==== | |||
{{Note|This method possibly might only when using the NixOS service. If this command fails, use the INI Method described below}} | |||
<syntaxhighlight lang="bash"> | |||
sudo etebase-server createsuperuser | |||
</syntaxhighlight> | |||
==== INI Method ==== | |||
First you need to find where the generated {{ic|.ini}} configuration file is located: | First you need to find where the generated {{ic|.ini}} configuration file is located: | ||
<syntaxHighlight lang=sh> | <syntaxHighlight lang=sh> | ||
| Line 47: | Line 54: | ||
As a super user, run this command: <code>ETEBASE_EASY_CONFIG_PATH=/path/to/etebase-server.ini etebase-server createsuperuser</code> and that should prompt you to create a user. | As a super user, run this command: <code>ETEBASE_EASY_CONFIG_PATH=/path/to/etebase-server.ini etebase-server createsuperuser</code> and that should prompt you to create a user. | ||
==== After ==== | |||
Login with these credentials to https://etebase.your.domain/admin and create users for your etebase clients through the GUI. | Login with these credentials to https://etebase.your.domain/admin and create users for your etebase clients through the GUI. | ||