https://github.com/tjanez/bup-package

https://github.com/tjanez/bup-package

Last synced: about 1 month ago
JSON representation

• Host: GitHub
• URL: https://github.com/tjanez/bup-package
• Owner: tjanez
• Created: 2015-05-17T18:38:08.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2017-01-10T15:22:51.000Z (almost 8 years ago)
• Last Synced: 2024-10-12T12:17:37.739Z (2 months ago)
• Size: 27.3 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README-bup-web.Fedora.md

Awesome Lists containing this project

README

        
Notes on Fedora bup-web Package

===============================

The bup-web package provides the `bup web` command which runs a web server for

browsing through bup repositories.

For convenience, it also provides a systemd unit file for running `bup web`

as a service with the systemd user instance (i.e. `systemd --user`).

Usage

-----

### Managing systemd user service

*NOTE: All commands should be executed as an ordinary (non-root) user.*

To enable the bup-web user service, execute:

    systemctl --user enable bup-web.service

To start the bup-web user service, execute:

    systemctl --user start bup-web.service

To see the status of the bup-web user service, execute:

    systemctl --user status bup-web.service

To stop the bup-web user service, execute:

    systemctl --user stop bup-web.service

To disable the bup-web user service, execute:

    systemctl --user disable bup-web.service

### Browsing bup repositories

Open your web browser and go to:

    127.0.0.1:8080

*NOTE: By default, bup-web only accepts requests from local clients.

To expose it to whole network, add `0.0.0.0:` to its command line.

For more details on editing bup-web's configuration, see the next section.*

Configuration

-------------

Currently, bup-web user service can only be configured by manually editing its

systemd unit file.

If you've previously enabled bup-web user service, disable it with:

    systemctl --user disable bup-web.service

Then copy the package-provided unit file to your systemd user instance

configuration directory:

    cp /usr/lib/systemd/user/bup-web.service ~/.config/systemd/user/

Edit the unit file to suit your needs.

Finally, enable the bup-web user service with:

    systemctl --user enable bup-web.service

Troubleshooting

---------------

If the bup-web user service fails to start, examine its journal records by

executing:

    journalctl --user-unit bup-web.service

Authors

-------

Tadej Janež