FreedomBox/plinth/modules/networks/templates/router_configuration_content.html
Sunil Mohan Adapa 168f662a17
*: Update URL base from /plinth to /freedombox
- Since we are going to be an OpenID Provider, we need to fix the URLs that
other apps will be configured with for authentication. So change now from
/plinth to /freedombox. If done later, it will be harder since all the
configuration files for all dependent apps will need to be updated.

Tests:

- App availability checking works. Request goes to /freedombox URL

- Favicon is served properly and through /favicon.ico URL

- Redirection happens from / to /freedombox directly

- UI is available on /freedombox and on /plinth

- Manual page show /freedombox as the URL in two places

- Static files are successfully served from /freedombox URLs. URLs inside page
start with /freedombox

- backup, bepasty, calibre, config, dynamicdns, ejabberd, featherwiki, gitweb,
ikiwiki, kiwix, miniflux, names, openvpn, shadowsocks, shadowsocksserver,
sharing, shapshot, tiddlywiki, users, wireguard, jsxc, matrixsynapse, first
wizard, storage, samba, tags functional tests work. Backup/restore test for
matrixsynapse fails due to an unrelated bug (server not restarted after
restore).

- Setting the home page works:

  - Having /plinth in the home page configuration works. Shows selection
    correctly.

  - Setting to app works. Shows selection correctly.

  - Setting to user home page (sets /freedombox). Shows selection correctly.

  - Setting to apache default works. Shows selection correctly.

  - Changing back to FreedomBox service works. Shows selection correctly.

- Unit tests work

- Configuration page shows /freedombox in description but not /plinth

- Diagnostics show /freedombox in tests

- Roundcube URL link in email app has /freedombox

- email loads the page /.well-known/autoconfig/mail/config-v1.1.xml correctly

- email app shows /freedombox/apps/roundcube for /roundcube if roundcube is not
installed.

- networks: router configuration page shows URL starting with /freedombox.

- snapshot: Shows URL starting with /freedombox on the app page

- js licenses page uses /freedombox prefix for JSXC.

Signed-off-by: Sunil Mohan Adapa <sunil@medhas.org>
Reviewed-by: James Valleroy <jvalleroy@mailbox.org>
2026-03-02 20:50:30 -05:00

63 lines
2.0 KiB
HTML

{% comment %}
# SPDX-License-Identifier: AGPL-3.0-or-later
{% endcomment %}
{% load bootstrap %}
{% load i18n %}
{% load static %}
<h1>
{% blocktrans trimmed %}
Setup {{ box_name }} Behind a Router
{% endblocktrans %}
</h1>
<p>
{% blocktrans trimmed %}
Your {{ box_name }} gets its internet connection from your router via
Wi-Fi or Ethernet cable. This is a typical home setup.
{% endblocktrans %}
</p>
<p>
{% blocktrans trimmed %}
With this setup, any device on the internet trying to reach your
{{ box_name }} will have to go through your router. The router will need
to be configured to forward all traffic it receives so that {{ box_name }}
provides the services.
{% endblocktrans %}
</p>
<p>
{% blocktrans trimmed %}
If you don't have control over your router, choose not to configure it. To
see options to overcome this limitation, choose 'I dont have a public IP address' option
in <a href="/freedombox/sys/networks/internet-connection-type/">Internet connection type selection</a>.
{% endblocktrans %}
</p>
<h2>{% trans "Choose How You Wish to Configure Your Router" %}</h2>
<p class='help-block'>
{% blocktrans trimmed %}
You will need to login to your router's administration console provided by
the router. This may look like one of the following:
{% endblocktrans %}
</p>
<ul>
<li><a href="http://192.168.0.1/">http://192.168.0.1</a></li>
<li><a href="http://192.168.1.1/">http://192.168.1.1</a></li>
</ul>
<p class='help-block'>
{% blocktrans trimmed %}
The username and password is configured by you when you first setup the
router. For many routers, this information is printed at the back of the
router. If you don't remember the credentials or the IP address of the
router, you may decide to reset it and set it up freshly. Lookup your router
model number and search online for the router's manual. This will provide
full instructions on how to perform this task.
{% endblocktrans %}
</p>