id,page,ref,title,content,breadcrumbs,references
deploying:deploying-systemd,deploying,deploying-systemd,Running Datasette using systemd,"You can run Datasette on Ubuntu or Debian systems using  systemd . 
             First, ensure you have Python 3 and  pip  installed. On Ubuntu you can use  sudo apt-get install python3 python3-pip . 
             You can install Datasette into a virtual environment, or you can install it system-wide. To install system-wide, use  sudo pip3 install datasette . 
             Now create a folder for your Datasette databases, for example using  mkdir /home/ubuntu/datasette-root . 
             You can copy a test database into that folder like so: 
             cd /home/ubuntu/datasette-root
curl -O https://latest.datasette.io/fixtures.db 
             Create a file at  /etc/systemd/system/datasette.service  with the following contents: 
             [Unit]
Description=Datasette
After=network.target

[Service]
Type=simple
User=ubuntu
Environment=DATASETTE_SECRET=
WorkingDirectory=/home/ubuntu/datasette-root
ExecStart=datasette serve . -h 127.0.0.1 -p 8000
Restart=on-failure

[Install]
WantedBy=multi-user.target 
             Add a random value for the  DATASETTE_SECRET  - this will be used to sign Datasette cookies such as the CSRF token cookie. You can generate a suitable value like so: 
             python3 -c 'import secrets; print(secrets.token_hex(32))' 
             This configuration will run Datasette against all database files contained in the  /home/ubuntu/datasette-root  directory. If that directory contains a  metadata.yml  (or  .json ) file or a  templates/  or  plugins/  sub-directory those will automatically be loaded by Datasette - see  Configuration directory mode  for details. 
             You can start the Datasette process running using the following: 
             sudo systemctl daemon-reload
sudo systemctl start datasette.service 
             You will need to restart the Datasette service after making changes to its  metadata.json  configuration or adding a new database file to that directory. You can do that using: 
             sudo systemctl restart datasette.service 
             Once the service has started you can confirm that Datasette is running on port 8000 like so: 
             curl 127.0.0.1:8000/-/versions.json
# Should output JSON showing the installed version 
             Datasette will not be accessible from outside the server because it is listening on  127.0.0.1 . You can expose it by instead listening on  0.0.0.0 , but a better way is to set up a proxy such as  nginx  - see  Running Datasette behind a proxy .","[""Deploying Datasette""]",[]