Introduction

The webserver enables you to schedule recordings with a webbrowser, have a list of your image, movie and audio directories and more ... To schedule recordings you have to configure and start the Recordserver.

Security warning!

If you choose to run the freevo webserver as root you will expose your entire file system to anyone who has access. A user will be able to request for example /etc/shadow and have that file served straight up to them.

Setup

In local_conf.py set the following:

WWW_USERS - provide yourself with a username and password.
Click here for how to avoid putting your password in plain text into local_conf.py
WEBSERVER_PORT and choose the port you want the webserver to run on
WEBSERVER_UID and WEBSERVER_GID and set them to the user (not root hopefully) that you want the server to run as.

Start manually

To start the webserver manually:

freevo webserver --start

To stop the webserver manually:

freevo webserver --stop

Start as plugin

To start is like other plugins, add the following to your local_conf.py :

plugin.activate('www')

DXR3 users must use the webserver in either inittab or boot scripts. it will not work for them in plugin mode.

Start with initscript

Gentoo

If you emerged freevo from portage :

Edit the config script : /etc/conf.d/freevo
Add Freevo script to the default runlevel :

rc-update add freevo default

Debian

If you installed with apt-get :

Edit /etc/default/freevo

START_FREEVO_WEBSERVER=1

This reads /etc/freevo/local_conf.py not /root/.freevo/local_conf.py
Make sure you have edited this file for the webserver to run properly

Other distributions

PleaseUpdate

Start from inittab

PleaseUpdate

Usage

After you started the webserver you can point your browser to http://name:port Where name is the name of the computer where the webserver is started and port is the port you have configured with 'WEBSERVER_PORT'

If you set the webserver to start at boot, it will run as root. It will use the settings from /etc/freevo/local_conf.py, not those from /home/user/.freevo/local_conf.py. Remember to set some usernames and passwords here or you won't be able to login.

Username and password will be asked. If you want to access this workstation from the internet, don't forget to open / forward the port if you have a firewall or router.

If you have a DHCP internet IP address I suggest using something like http://www.dyndns.org/.

The webserver also has some wap pages. Point your web browser to http://name:port/wap_login.rpy , after logging in there will be a basic wap record page.