doc: Fetch latest manual
@ -14,13 +14,15 @@
|
||||
|
||||
=== What is User Websites? ===
|
||||
|
||||
User websites is a standard location for webservers to allow host users to expose static files on the filesystem as a website to the local network and/or the internet according to the network and firewall setup.
|
||||
User websites is a feature that allows any (even non-admin) user on a !FreedomBox to host their own website simply by copying files to well known location in their home directory on the !FreedomBox server. The URL for the website will look like `https://mydomain.example/~myusername/`. The website will be available on the local network and/or the internet according to the network and firewall setup. If the copied files are HTML pages, they will show up as a website. If they are other types of files such as photos or documents. A list of those files is shown and a visitor will be able to view or download them.
|
||||
|
||||
The standard webserver in !FreedomBox is Apache and this is implemented by means of a specific Apache module.
|
||||
Apache is the web server used in !FreedomBox and this feature is implemented using an Apache module.
|
||||
|
||||
=== Screenshot ===
|
||||
|
||||
/* Add when/if an interface is made for FreedomBox */
|
||||
{{attachment:user-websites-folder.png|User Website copied to FreedomBox using GNOME File Browser}}
|
||||
|
||||
{{attachment:user-websites-browser.png|User Website accessed using a browser}}
|
||||
|
||||
=== Using User Websites ===
|
||||
|
||||
@ -30,9 +32,8 @@ To serve documents, place the files in the designated directory in a !FreedomBox
|
||||
|
||||
This directory is: '''public_html'''
|
||||
|
||||
Thus the absolute path for the directory of a user named fbx with home directory in /home/fbx will be '''/home/fbx/public_html'''.
|
||||
User websites will serve documents placed in this directory when requests for documents with the URI path "~fbx" are received. For the the `example.org` domain thus a request for the document `example.org/~fbx/index.html` will transfer the file in `/home/fbx/public_html/index.html`.
|
||||
|
||||
Thus, the absolute path for the directory of a user named ''fbx'' with home directory in ''/home/fbx'' will be '''/home/fbx/public_html'''.
|
||||
The User Websites feature will serve documents placed in this directory when requests for documents with the URI path ''~fbx'' are received. For example, if `mydomain.example` is your domain then a request for the URL `https://mydomain.example/~fbx/photo.jpg` will display the file in `/home/fbx/public_html/photo.jpg`. If a file named ''index.html'' is placed in the directory, it will shown when no file name is provided in the URL. So, the URL `https://mydomain.example/~fbx/` will show the HTML page `/home/fbx/public_html/index.html`
|
||||
|
||||
=== Creating public_html folder and uploading documents ===
|
||||
|
||||
@ -44,7 +45,7 @@ Linux standard desktop file managers use to support remote filesystem access thr
|
||||
* Gnome's Nautilus:
|
||||
1. To lauch Nautilus you can seek its archive icon, or search ether its name or the word "file".
|
||||
1. At the bottom of the left pane you'll find an option "+ Other locations".
|
||||
1. It leads you to a list of locations. Find "`freedombox SFTP server`" (english literal for all desktop languages). Click on it.
|
||||
1. It leads you to a list of locations. Find "`freedombox SFTP server`" (english literal for all desktop languages). Click on it. If you don't find this, you can instead type `sftp://username@freedombox.local` in the address bar.
|
||||
1. The first time you'll be asked for your user and password. Enter your !FreedomBox user and its password. The dialog will also offer you some options to remember it for some time.
|
||||
* Plasma file manager AKA Dolphin:
|
||||
1. Click on the location bar at the top of the window.
|
||||
|
||||
@ -44,36 +44,11 @@ It is important to verify the images you have downloaded to ensure that the file
|
||||
|
||||
* First open a terminal and import the public keys of the !FreedomBox developers who built the images:
|
||||
{{{
|
||||
$ gpg --keyserver keyserver.ubuntu.com --recv-keys BCBEBD57A11F70B23782BC5736C361440C9BC971
|
||||
$ gpg --keyserver keyserver.ubuntu.com --recv-keys 7D6ADB750F91085589484BE677C0C75E7B650808
|
||||
# This is the FreedomBox CI server's key
|
||||
$ gpg --keyserver keyserver.ubuntu.com --recv-keys 013D86D8BA32EAB4A6691BF85D4153D6FE188FC8
|
||||
# This is the new FreedomBox CI server's key
|
||||
$ gpg --keyserver keyserver.ubuntu.com --recv-keys D4B069124FCF43AA1FCD7FBC2ACFC1E15AF82D8C
|
||||
}}}
|
||||
* Next, verify the fingerprint of the public keys:
|
||||
{{{
|
||||
$ gpg --fingerprint BCBEBD57A11F70B23782BC5736C361440C9BC971
|
||||
pub 4096R/0C9BC971 2011-11-12
|
||||
Key fingerprint = BCBE BD57 A11F 70B2 3782 BC57 36C3 6144 0C9B C971
|
||||
uid Sunil Mohan Adapa <sunil@medhas.org>
|
||||
sub 4096R/4C1D4B57 2011-11-12
|
||||
|
||||
$ gpg --fingerprint 7D6ADB750F91085589484BE677C0C75E7B650808
|
||||
pub 4096R/7B650808 2015-06-07 [expires: 2020-06-05]
|
||||
Key fingerprint = 7D6A DB75 0F91 0855 8948 4BE6 77C0 C75E 7B65 0808
|
||||
uid James Valleroy <jvalleroy@mailbox.org>
|
||||
uid James Valleroy <jvalleroy@freedombox.org>
|
||||
sub 4096R/25D22BF4 2015-06-07 [expires: 2020-06-05]
|
||||
sub 4096R/DDA11207 2015-07-03 [expires: 2020-07-01]
|
||||
sub 2048R/2A624357 2015-12-22
|
||||
|
||||
$ gpg --fingerprint 013D86D8BA32EAB4A6691BF85D4153D6FE188FC8
|
||||
pub rsa4096 2018-06-06 [SC]
|
||||
013D 86D8 BA32 EAB4 A669 1BF8 5D41 53D6 FE18 8FC8
|
||||
uid [ unknown] FreedomBox CI (Continuous Integration server) <admin@freedombox.org>
|
||||
sub rsa4096 2018-06-06 [E]
|
||||
|
||||
$ gpg --fingerprint D4B069124FCF43AA1FCD7FBC2ACFC1E15AF82D8C
|
||||
pub rsa4096 2022-03-09 [SC]
|
||||
D4B0 6912 4FCF 43AA 1FCD 7FBC 2ACF C1E1 5AF8 2D8C
|
||||
@ -250,6 +225,37 @@ dd if=temp/usr/lib/u-boot/A20-OLinuXino-Lime2/u-boot-sunxi-with-spl.bin of=<lime
|
||||
|
||||
The resulting image will have the modified u-boot in it.
|
||||
|
||||
=== Old Signing Keys ===
|
||||
|
||||
Some very old disk images of !FreedomBox have been signed by different GPG keys than the one listed above. Those signatures are still valid and can be verified using the older keys.
|
||||
|
||||
{{{
|
||||
$ gpg --keyserver keyserver.ubuntu.com --recv-keys BCBEBD57A11F70B23782BC5736C361440C9BC971
|
||||
$ gpg --keyserver keyserver.ubuntu.com --recv-keys 7D6ADB750F91085589484BE677C0C75E7B650808
|
||||
# This is the FreedomBox CI server's key
|
||||
$ gpg --keyserver keyserver.ubuntu.com --recv-keys 013D86D8BA32EAB4A6691BF85D4153D6FE188FC8
|
||||
$ gpg --fingerprint BCBEBD57A11F70B23782BC5736C361440C9BC971
|
||||
pub 4096R/0C9BC971 2011-11-12
|
||||
Key fingerprint = BCBE BD57 A11F 70B2 3782 BC57 36C3 6144 0C9B C971
|
||||
uid Sunil Mohan Adapa <sunil@medhas.org>
|
||||
sub 4096R/4C1D4B57 2011-11-12
|
||||
|
||||
$ gpg --fingerprint 7D6ADB750F91085589484BE677C0C75E7B650808
|
||||
pub 4096R/7B650808 2015-06-07 [expires: 2020-06-05]
|
||||
Key fingerprint = 7D6A DB75 0F91 0855 8948 4BE6 77C0 C75E 7B65 0808
|
||||
uid James Valleroy <jvalleroy@mailbox.org>
|
||||
uid James Valleroy <jvalleroy@freedombox.org>
|
||||
sub 4096R/25D22BF4 2015-06-07 [expires: 2020-06-05]
|
||||
sub 4096R/DDA11207 2015-07-03 [expires: 2020-07-01]
|
||||
sub 2048R/2A624357 2015-12-22
|
||||
|
||||
$ gpg --fingerprint 013D86D8BA32EAB4A6691BF85D4153D6FE188FC8
|
||||
pub rsa4096 2018-06-06 [SC]
|
||||
013D 86D8 BA32 EAB4 A669 1BF8 5D41 53D6 FE18 8FC8
|
||||
uid [ unknown] FreedomBox CI (Continuous Integration server) <admin@freedombox.org>
|
||||
sub rsa4096 2018-06-06 [E]
|
||||
}}}
|
||||
|
||||
## END_INCLUDE
|
||||
|
||||
<<Include(FreedomBox/Portal)>>
|
||||
|
||||
@ -16,6 +16,12 @@ Dynamic DNS service providers assist in working around a problem. First they pr
|
||||
|
||||
For this to work, every time you connect to the Internet, you will have to tell your Dynamic DNS provider what your current IP address is. Hence you need special software on your server to perform this operation. The Dynamic DNS function in !FreedomBox will allow users without a static public IP address to push the current public IP address to a Dynamic DNS Server. This allows you to expose services on !FreedomBox, such as ownCloud, to the Internet.
|
||||
|
||||
=== A Free Domain for your FreedomBox ===
|
||||
|
||||
You can get a free domain name for your !FreedomBox using the free Dynamic DNS service provided by the !FreedomBox community at https://ddns.freedombox.org . With this service, your domain name will look like ''myaccount.fbx.one'' or ''myaccount.freedombox.rocks'' where ''myaccount'' is the account you created on the service.
|
||||
|
||||
The service also provides you with free unlimited number of subdomains. For this, login to the account, go to ''Change Settings'', check the option ''Wild Card'', and click ''Save Changes''. After this you can add any number of subdomains like ''foo.myaccount.fbx.one'' to your !FreedomBox in ''System -> Names -> Add Domain (regular)''. TLS certificates (for HTTPS) will be automatically obtained by !FreedomBox using Let's Encrypt for these subdomains. Subdomains are especially useful for applications that require being hosted on a separate domain, such as [[FreedomBox/Manual/HomeAssistant|Home Assistant]].
|
||||
|
||||
=== GnuDIP vs. Update URL ===
|
||||
|
||||
There are two main mechanism to notify the Dynamic DNS server of your new IP address; using the ''GnuDIP'' protocol and using the ''Update URL'' mechanism.
|
||||
@ -27,7 +33,6 @@ On the other hand, the GnuDIP protocol will only transport a salted MD5 value of
|
||||
=== Using the GnuDIP protocol ===
|
||||
|
||||
1. Register an account with any Dynamic DNS service provider. A free service provided by the !FreedomBox community is available at https://ddns.freedombox.org .
|
||||
|
||||
1. In !FreedomBox UI, enable the Dynamic DNS Service.
|
||||
|
||||
1. Select ''GnuDIP'' as ''Service type'', enter your Dynamic DNS service provider address (for example, ddns.freedombox.org) into ''GnuDIP Server Address'' field.
|
||||
|
||||
@ -72,6 +72,7 @@ You might want to configure your wiki with different [[https://feather.wiki/?pag
|
||||
=== External links ===
|
||||
|
||||
* Website: https://feather.wiki
|
||||
* Source code for Feather Wiki: https://codeberg.org/Alamantus/FeatherWiki
|
||||
|
||||
## END_INCLUDE
|
||||
|
||||
|
||||
70
doc/manual/en/HomeAssistant.raw.wiki
Normal file
@ -0,0 +1,70 @@
|
||||
#language en
|
||||
|
||||
##TAG:TRANSLATION-HEADER-START
|
||||
~- [[FreedomBox/Manual/HomeAssistant|English]] - [[es/FreedomBox/Manual/HomeAssistant|Español]] - [[DebianWiki/EditorGuide#translation|(+)]]-~
|
||||
##TAG:TRANSLATION-HEADER-END
|
||||
|
||||
<<TableOfContents()>>
|
||||
|
||||
## BEGIN_INCLUDE
|
||||
|
||||
== Home Assistant ==
|
||||
||<tablestyle="float: right;"> {{attachment:homeassistant.png|Home Assistant icon}} ||
|
||||
|
||||
'''Available since''': version 25.10
|
||||
|
||||
Home Assistant is a home automation hub with emphasis on local control and privacy. It integrates with thousands of devices including smart bulbs, alarms, presence sensors, door bells, thermostats, irrigation timers, energy monitors, etc.
|
||||
|
||||
Please note that Home Assistant is installed and run inside a container provided by the Home Assistant project. Security, quality, privacy and legal reviews are done by the upstream project and not by Debian/FreedomBox. Updates are performed following an independent cycle.
|
||||
|
||||
Home Assistant app is considered experimental in !FreedomBox as it is fairly new to our ecosystem. You may face issues working with it or the app may undergo major breaking changes.
|
||||
|
||||
=== Hardware ===
|
||||
|
||||
Home Assistant can detect, configure, and use various devices on the local network. For example, if a device is connected using Wi-Fi or LAN to the same network as !FreedomBox, Home Assistant can detect, configure, and use the device. Other home automation protocols such as Thread, !ZigBee, and Z-Wave are also supported but require additional hardware to be connected to your !FreedomBox. For example, if you have a door sensor that speaks !ZigBee, you need to attach a !ZigBee USB dongle to your !FreedomBox. Home Assistant can then detect and use the door sensor on the !ZigBee network.
|
||||
|
||||
Home Assistant is a comprehensive solution for your home automation needs supporting thousands of devices. You can check whether a device is supported by Home Assistant by visiting the [[https://www.home-assistant.io/integrations/|integrations]] page. Other devices which are not listed may also be supported when they are similar to supported devices. It is recommended that you purchase hardware that advertises support for Home Assistant.
|
||||
|
||||
Many home automation devices connect to or send data to their manufacturers' servers. This can be a serious violation of your home's privacy. These devices may also stop working when their manufacturer goes bankrupt, decides to close the product line, or forces you to purchase newer models. It is strongly recommended that you purchase hardware that works locally with a home automation hub (in this case Home Assistant) without connecting to manufacturer's servers. These are listed under the categories "Local Push" or "Local Polling" in the Home Assistant's integrations page.
|
||||
|
||||
=== Setup ===
|
||||
|
||||
After the app is installed, Home Assistant web interface must be setup. An administrator account is created at this time. Home Assistant maintains its own user accounts separate from user accounts created on !FreedomBox.
|
||||
|
||||
{{attachment:homeassistant-setup-step-1.png|Setup - Step 1}}
|
||||
|
||||
{{attachment:homeassistant-setup-step-2.png|Setup - Step 2}}
|
||||
|
||||
{{attachment:homeassistant-setup-step-3.png|Setup - Step 3}}
|
||||
|
||||
{{attachment:homeassistant-setup-step-4.png|Setup - Step 4}}
|
||||
|
||||
{{attachment:homeassistant-setup-step-5.png|Setup - Step 5}}
|
||||
|
||||
When new USB dongles are added to make Home Assistant talk to devices on networks like Thread, !ZigBee, and Z-Wave, then setup operation must be re-run on the app. This operation is available in the Extras menu drop down with gears icon in the Home Assistant app page. Setup must also be re-run when the hardware is removed. Otherwise, Home Assistant service will fail to start.
|
||||
|
||||
=== Usage ===
|
||||
|
||||
Home Assistant provides a fully functional web application and a mobile application. Simply login and start using:
|
||||
|
||||
{{attachment:homeassistant-login.png|Login}}
|
||||
|
||||
{{attachment:homeassistant-ui.png|Web UI}}
|
||||
|
||||
|
||||
{{attachment:homeassistant-app.png|Mobile App}}
|
||||
|
||||
=== External links ===
|
||||
|
||||
* Website: https://www.home-assistant.io/
|
||||
* Source code for Home Assistant: https://github.com/home-assistant/core
|
||||
* Source code for Home Assistant container image: https://github.com/home-assistant/docker
|
||||
|
||||
## END_INCLUDE
|
||||
|
||||
Back to [[FreedomBox/Features|Features introduction]] or [[FreedomBox/Manual|manual]] pages.
|
||||
|
||||
<<Include(FreedomBox/Portal)>>
|
||||
|
||||
----
|
||||
CategoryFreedomBox
|
||||
@ -39,7 +39,8 @@ If you are a Nextcloud user share how this is done.
|
||||
* Upstream Project: https://nextcloud.com/
|
||||
* Upstream documentation: https://nextcloud.com/support/
|
||||
* Upstream support forum: https://help.nextcloud.com/
|
||||
* The source code for the container image used by !FreedomBox: https://github.com/nextcloud/docker
|
||||
* Source code for Nextcloud: https://download.nextcloud.com/server/releases/
|
||||
* Source code for the container image: https://github.com/nextcloud/docker (includes links to source code for other components)
|
||||
* Debian Nextcloud wiki: https://wiki.debian.org/Nextcloud
|
||||
|
||||
{{{#!wiki comment
|
||||
|
||||
@ -8,6 +8,52 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f
|
||||
|
||||
The following are the release notes for each !FreedomBox version.
|
||||
|
||||
== FreedomBox 25.11 (2025-09-08) ==
|
||||
|
||||
=== Highlights ===
|
||||
|
||||
* email: Fix Thunderbird auto configuration failure
|
||||
* matrixsynapse, upgrades: Install select packages from unstable
|
||||
|
||||
=== Other Changes ===
|
||||
|
||||
* action_utils: Implement a utility to run a command as different user
|
||||
* actions, backup: Implement raw output for privileged daemon
|
||||
* actions, backups: Fix tests depending on sudo based actions
|
||||
* actions: Drop feature to run privileged action as another user
|
||||
* actions: Drop sudo based privileged actions
|
||||
* actions: Framework for capturing stdout/stderr in privileged daemon
|
||||
* actions: Simplify raw output code in privileged methods
|
||||
* backups: Trim translatable string
|
||||
* container: Add support for Trixie as stable distribution
|
||||
* container: Pass --nvram option to virsh undefine
|
||||
* d/control: Remove libpam-abl as a recommendation
|
||||
* diagnostics: Fix notification severity when skipping tests
|
||||
* dynamicdns: Handle showing errors from GnuDIP
|
||||
* gitweb: Don't use privileged action feature to run as different user
|
||||
* gitweb: Use pathlib API more
|
||||
* HACKING.md: Mention using virtual machines instead of containers
|
||||
* homeassistant: Fix typo in description
|
||||
* l10n: Fix a broken string in Russian translation
|
||||
* l10n: Fix broken Italian translation
|
||||
* l10n: Fix formatted strings for errors/exceptions
|
||||
* locale: Update translations for Bulgarian, Chinese (Simplified Han script), Czech, Dutch, French, German, Italian, Russian, Turkish, Ukrainian
|
||||
* Makefile, settings: Use full paths in pot files
|
||||
* package: Don't consider uninstalled packages as available
|
||||
* package: Refresh apt cache if sources list is newer
|
||||
* power: logind config to ignore laptop lid close
|
||||
* privileged: Don't isolate /var/tmp/ for privileged daemon
|
||||
* privileged_daemon: Introduce a command line client for the API
|
||||
* privileged_daemon: Log only to journal and not console
|
||||
* samba: Update client list
|
||||
* storage: Don't use privileged action feature to run as different user
|
||||
* syncthing: Update Android clients to Syncthing-Fork
|
||||
* tests: functional: Fix incorrect skipping of install tests
|
||||
* ui: Fix missing semicolon in JS file
|
||||
* upgrades: Don't allow needs-restart to restart privileged daemon
|
||||
* upgrades: Overhaul detection of distribution
|
||||
* web_server: Restart in development mode only for source code changes
|
||||
|
||||
== FreedomBox 25.10 (2025-08-18) ==
|
||||
|
||||
=== Highlights ===
|
||||
|
||||
@ -71,6 +71,7 @@ You can also have a custom image as the favicon for each !TiddlyWiki. Using a di
|
||||
|
||||
* Website: https://tiddlywiki.com
|
||||
* Grok !TiddlyWiki (online e-book): https://groktiddlywiki.com/read/
|
||||
* Source code for TiddlyWiki: https://github.com/TiddlyWiki/TiddlyWiki5
|
||||
|
||||
## END_INCLUDE
|
||||
|
||||
|
||||
@ -20,7 +20,9 @@ Note that once the updates start, it may take a long time to complete. During au
|
||||
|
||||
Although updates are done every day for security reasons, latest features of !FreedomBox will not propagate to all the users. The following information should help you understand how new features become available to users.
|
||||
|
||||
'''Stable Users''': This category of users include users who bought the [[FreedomBox/Hardware/PioneerEdition|FreedomBox Pioneer Edition]], installed !FreedomBox on a [[FreedomBox/Hardware/Debian|Debian]] stable distribution or users who downloaded the ''stable'' images from [[https://freedombox.org|freedombox.org]]. As a general rule, only security updates to various packages are provided to these users. One exception to this rule is where !FreedomBox service itself is updated when a release gains high confidence from developers. This means that latest !FreedomBox features may become available to these users although after a few days of delay compared to ''testing'' users. If an app is available only in ''testing'' distribution but not in ''stable'' distribution, then that app will show up in the web interface but will not be installable by ''stable'' users. Some apps are also provided an exception to the rule of "security updates only" when the app is severely broken otherwise. Every two years, a major release of Debian stable happens with the latest versions of all the software packages and !FreedomBox developers will attempt to upgrade these users to the new release without requiring manual intervention. See the sections on upgrade to next stable release below.
|
||||
'''Stable Users''': This category of users include users who bought the [[FreedomBox/Hardware/PioneerEdition|FreedomBox Pioneer Edition]], installed !FreedomBox on a [[FreedomBox/Hardware/Debian|Debian]] stable distribution or users who downloaded the ''stable'' images from [[https://freedombox.org|freedombox.org]]. If an app is available only in ''testing'' distribution but not in ''stable'' distribution, then that app will show up in the web interface but will not be installable by ''stable'' users. Every two years, a major release of Debian stable happens with the latest versions of all the software packages and !FreedomBox developers will attempt to upgrade these users to the new release without requiring manual intervention. See the sections on upgrade to next stable release below.
|
||||
|
||||
As a general rule, only security updates to various packages are provided to these users. One exception to this rule is when ''frequent feature updates'' (recommended) option is enabled. When this option is enabled, !FreedomBox service itself is updated when a release gains high confidence from developers. This means that latest !FreedomBox features may become available to these users (after a few days of delay compared to ''testing'' users). Some apps (currently only Matrix Synapse) are also provided as an exception to the rule of "security updates only" when the app is severely broken or unavailable otherwise. Technically, when this option is enabled, after thorough testing, a select list of packages may be installed from ''backports'' or ''unstable'' repositories of Debian.
|
||||
|
||||
'''Testing Users''': This category of users include users who installed !FreedomBox on a [[FreedomBox/Hardware/Debian|Debian]] ''testing'' distribution or users who downloaded the ''testing'' images from [[https://freedombox.org|freedombox.org]]. Users who use Debian ''testing'' are likely to face occasional disruption in the services and may even need manual intervention to fix the issue. As a general rule, these users receive all the latest features and security updates to all the installed packages. Every two weeks, a new version of !FreedomBox is released with all the latest features and fixes. These releases will reach ''testing'' users approximately 2-3 days after the release.
|
||||
|
||||
|
||||
@ -24,6 +24,7 @@
|
||||
<<Include(FreedomBox/Manual/Email, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(FreedomBox/Manual/FeatherWiki, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(FreedomBox/Manual/GitWeb, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(FreedomBox/Manual/HomeAssistant, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(FreedomBox/Manual/Ikiwiki, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(FreedomBox/Manual/Infinoted, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(FreedomBox/Manual/Janus, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
|
||||
BIN
doc/manual/en/images/homeassistant-app.png
Normal file
|
After Width: | Height: | Size: 66 KiB |
BIN
doc/manual/en/images/homeassistant-login.png
Normal file
|
After Width: | Height: | Size: 57 KiB |
BIN
doc/manual/en/images/homeassistant-setup-step-1.png
Normal file
|
After Width: | Height: | Size: 62 KiB |
BIN
doc/manual/en/images/homeassistant-setup-step-2.png
Normal file
|
After Width: | Height: | Size: 57 KiB |
BIN
doc/manual/en/images/homeassistant-setup-step-3.png
Normal file
|
After Width: | Height: | Size: 263 KiB |
BIN
doc/manual/en/images/homeassistant-setup-step-4.png
Normal file
|
After Width: | Height: | Size: 51 KiB |
BIN
doc/manual/en/images/homeassistant-setup-step-5.png
Normal file
|
After Width: | Height: | Size: 78 KiB |
BIN
doc/manual/en/images/homeassistant-ui.png
Normal file
|
After Width: | Height: | Size: 42 KiB |
BIN
doc/manual/en/images/homeassistant.png
Normal file
|
After Width: | Height: | Size: 12 KiB |
|
Before Width: | Height: | Size: 136 KiB After Width: | Height: | Size: 46 KiB |
BIN
doc/manual/en/images/user-websites-browser.png
Normal file
|
After Width: | Height: | Size: 22 KiB |
BIN
doc/manual/en/images/user-websites-folder.png
Normal file
|
After Width: | Height: | Size: 31 KiB |
@ -41,35 +41,11 @@ Es importante verificar las imágenes que has descargado para asegurar que el fi
|
||||
|
||||
* Primero abre un terminal e importa las claves publicas de los desarrolladores de !FreedomBox que construyeron las imágenes:
|
||||
{{{
|
||||
$ gpg --keyserver keyserver.ubuntu.com --recv-keys BCBEBD57A11F70B23782BC5736C361440C9BC971
|
||||
$ gpg --keyserver keyserver.ubuntu.com --recv-keys 7D6ADB750F91085589484BE677C0C75E7B650808
|
||||
# Esta es la clave del servidor de integración contínua de FreedomBox
|
||||
$ gpg --keyserver keyserver.ubuntu.com --recv-keys 013D86D8BA32EAB4A6691BF85D4153D6FE188FC8
|
||||
# Esta es la clave del uevo servidor de integración contínua de FreedomBox
|
||||
# Esta es la clave del nuevo servidor de integración contínua de FreedomBox
|
||||
$ gpg --keyserver keyserver.ubuntu.com --recv-keys D4B069124FCF43AA1FCD7FBC2ACFC1E15AF82D8C
|
||||
}}}
|
||||
* A continuación, verifica la huella de las claves públicas:
|
||||
{{{
|
||||
$ gpg --fingerprint BCBEBD57A11F70B23782BC5736C361440C9BC971
|
||||
pub 4096R/0C9BC971 2011-11-12
|
||||
Key fingerprint = BCBE BD57 A11F 70B2 3782 BC57 36C3 6144 0C9B C971
|
||||
uid Sunil Mohan Adapa <sunil@medhas.org>
|
||||
sub 4096R/4C1D4B57 2011-11-12
|
||||
|
||||
$ gpg --fingerprint 7D6ADB750F91085589484BE677C0C75E7B650808
|
||||
pub 4096R/7B650808 2015-06-07 [expires: 2020-06-05]
|
||||
Key fingerprint = 7D6A DB75 0F91 0855 8948 4BE6 77C0 C75E 7B65 0808
|
||||
uid James Valleroy <jvalleroy@mailbox.org>
|
||||
uid James Valleroy <jvalleroy@freedombox.org>
|
||||
sub 4096R/25D22BF4 2015-06-07 [expires: 2020-06-05]
|
||||
sub 4096R/DDA11207 2015-07-03 [expires: 2020-07-01]
|
||||
sub 2048R/2A624357 2015-12-22
|
||||
|
||||
$ gpg --fingerprint 013D86D8BA32EAB4A6691BF85D4153D6FE188FC8
|
||||
pub rsa4096 2018-06-06 [SC]
|
||||
013D 86D8 BA32 EAB4 A669 1BF8 5D41 53D6 FE18 8FC8
|
||||
uid [ unknown] FreedomBox CI (Continuous Integration server) <admin@freedombox.org>
|
||||
sub rsa4096 2018-06-06 [E]
|
||||
|
||||
$ gpg --fingerprint D4B069124FCF43AA1FCD7FBC2ACFC1E15AF82D8C
|
||||
pub rsa4096 2022-03-09 [SC]
|
||||
@ -202,7 +178,7 @@ cd <directorio_fuente>
|
||||
|
||||
1. El código fuente de cualquier paquete se puede ver y buscar usando el interfaz web de [[https://sources.debian.org/|sources.debian.org]]. Por ejemplo, mira el paquete [[https://sources.debian.org/src/plinth/|plinth]].
|
||||
|
||||
1. El código fuente y el binario precompilado de cualquier version de un paquete, incluyendo versiones antigüas, se pueden obtener de [[https://snapshot.debian.org/|snapshot.debian.org]]. Por ejemplo, mira el paquete [[https://snapshot.debian.org/package/plinth/|plinth]].
|
||||
1. El código fuente y el binario precompilado de cualquier version de un paquete, incluyendo versiones antiguas, se pueden obtener de [[https://snapshot.debian.org/|snapshot.debian.org]]. Por ejemplo, mira el paquete [[https://snapshot.debian.org/package/plinth/|plinth]].
|
||||
|
||||
1. También puedes obtener los enlaces a la web del proyecto original, al control de versiones del proyecto original, al control de versiones de Debian, registro de cambios, etc. desde la página de control Debian para el proyecto en [[https://tracker.debian.org/|tracker.debian.org]]. Por ejemplo, mira la página de control para el paquete [[https://tracker.debian.org/pkg/plinth|plinth]].
|
||||
|
||||
@ -244,6 +220,37 @@ dd if=temp/usr/lib/u-boot/A20-OLinuXino-Lime2/u-boot-sunxi-with-spl.bin of=<lime
|
||||
|
||||
La imagen resultante tendrá el u-boot modificado.
|
||||
|
||||
=== Claves de firma antiguas ===
|
||||
|
||||
Algunas imágenes de disco de !FreedomBox muy antiguas se firmaron con claves GPG diferentes a las listadas anteriormente. Esas firmas siguen valiendo y se pueden verificar empleando las claves antiguas.
|
||||
|
||||
{{{
|
||||
$ gpg --keyserver keyserver.ubuntu.com --recv-keys BCBEBD57A11F70B23782BC5736C361440C9BC971
|
||||
$ gpg --keyserver keyserver.ubuntu.com --recv-keys 7D6ADB750F91085589484BE677C0C75E7B650808
|
||||
# Esta es la clave del servidor de integración contínua de FreedomBox
|
||||
$ gpg --keyserver keyserver.ubuntu.com --recv-keys 013D86D8BA32EAB4A6691BF85D4153D6FE188FC8
|
||||
$ gpg --fingerprint BCBEBD57A11F70B23782BC5736C361440C9BC971
|
||||
pub 4096R/0C9BC971 2011-11-12
|
||||
Key fingerprint = BCBE BD57 A11F 70B2 3782 BC57 36C3 6144 0C9B C971
|
||||
uid Sunil Mohan Adapa <sunil@medhas.org>
|
||||
sub 4096R/4C1D4B57 2011-11-12
|
||||
|
||||
$ gpg --fingerprint 7D6ADB750F91085589484BE677C0C75E7B650808
|
||||
pub 4096R/7B650808 2015-06-07 [expires: 2020-06-05]
|
||||
Key fingerprint = 7D6A DB75 0F91 0855 8948 4BE6 77C0 C75E 7B65 0808
|
||||
uid James Valleroy <jvalleroy@mailbox.org>
|
||||
uid James Valleroy <jvalleroy@freedombox.org>
|
||||
sub 4096R/25D22BF4 2015-06-07 [expires: 2020-06-05]
|
||||
sub 4096R/DDA11207 2015-07-03 [expires: 2020-07-01]
|
||||
sub 2048R/2A624357 2015-12-22
|
||||
|
||||
$ gpg --fingerprint 013D86D8BA32EAB4A6691BF85D4153D6FE188FC8
|
||||
pub rsa4096 2018-06-06 [SC]
|
||||
013D 86D8 BA32 EAB4 A669 1BF8 5D41 53D6 FE18 8FC8
|
||||
uid [ unknown] FreedomBox CI (Continuous Integration server) <admin@freedombox.org>
|
||||
sub rsa4096 2018-06-06 [E]
|
||||
}}}
|
||||
|
||||
|
||||
## END_INCLUDE
|
||||
|
||||
|
||||
69
doc/manual/es/HomeAssistant.raw.wiki
Normal file
@ -0,0 +1,69 @@
|
||||
#language es
|
||||
|
||||
<<Include(FreedomBox/Manual/HomeAssistant, ,from="^##TAG:TRANSLATION-HEADER-START",to="^##TAG:TRANSLATION-HEADER-END")>>
|
||||
|
||||
<<TableOfContents()>>
|
||||
|
||||
## BEGIN_INCLUDE
|
||||
|
||||
== Home Assistant ==
|
||||
||<tablestyle="float: right;"> {{attachment:FreedomBox/Manual/HomeAssistant/homeassistant.png|icono de Home Assistant}} ||
|
||||
|
||||
|
||||
'''Disponible desde''': versión 25.10
|
||||
|
||||
Home Assistant es un centro de automatización del hogar con énfasis en control local y privacidad. Se integra con centenas de dispositivos inteligentes, incluyendo bombillas, alarmas, sensores de presencia, timbres, termostatos, temporizadores de riego, monitores de energía, etc.
|
||||
|
||||
Observa que Home Assistant se instala y ejecuta dentro de un contenedor proporcionado por el proyecto Home Assistant. Las revisiones de seguridad, calidad, privacidad y legislación las hace el proyecto en origen, ni Debian ni FreedomBox. Las actualizaciones también siguen un ciclo independiente.
|
||||
|
||||
La app Home Assistant se considera experimental en !FreedomBox, ya que es nueva en nuestro ecosistema. Podrías experimentar problemas y la propia app podría sufrir cambios importantes o disruptivos.
|
||||
|
||||
=== Hardware ===
|
||||
|
||||
Home Assistant puede detectar, configurar, y usar varios dispositivos de la red local. Por ejemplo, si un dispositivo se conecta mediante Wi-Fi o LAN a la misma red que !FreedomBox, Home Assistant puede detectarlo, configurarlo, y usarlo. También se soportan otros protocolos de automatización como Thread, !ZigBee, y Z-Wave, pero requieren hardware adicional para conectarlos a tu !FreedomBox. Por ejemplo, si tienes un sensor de puerta que habla !ZigBee, necesitas conectar un adaptador !ZigBee USB a tu !FreedomBox. Home Assistant podrá entonces detectar y usar el sensor de puerta en la red de !ZigBee.
|
||||
|
||||
Home Assistant es una solución completa si tu automatización del hogar necesita soportar miles de dispositivos. Puedes consultar si Home Assistant soporta un dispositivo visitando su página de [[https://www.home-assistant.io/integrations/|integraciones]]. Otros dispositivos similares a los soportados podrían estarlo aunque no figuren en la lista. Se recomienda comprar hardware etiquetado como compatible con Home Assistant.
|
||||
|
||||
Muchos dispositivos de automatización del hogar se conectan a los servidores de los fabricantes y les envían tus datos. Esto pserious ede suponer una violación muy seria de la privacidad de tu hogar. Estos dispositivos podrían también dejar de funcionar si su fabricante quebrara, decidiera descontinuar la línea de producto, o te forzara a comprar modelos más modernos. Se recomienda decididamente que compres hardware que funcione localmente con un centro de automatización del hogar (en este caso Home Assistant) sin conectarse a los servidores del fabricante. En la página de [[https://www.home-assistant.io/integrations/|integraciones]] de Home Assistant, estos dispositivos aparecen listados en las categorías "Local Push" o "Local Polling".
|
||||
|
||||
=== Arranque ===
|
||||
|
||||
Tras instalar la app hay que levantar el interfaz web de Home Assistant. Con ello se crea una cuenta de administrador. Home Assistant mantiene su propias cuentas de usuario diferentes de las de la !FreedomBox.
|
||||
|
||||
{{attachment:FreedomBox/Manual/HomeAssistant/homeassistant-setup-step-1.png|Setup - Step 1}}
|
||||
|
||||
{{attachment:FreedomBox/Manual/HomeAssistant/homeassistant-setup-step-2.png|Setup - Step 2}}
|
||||
|
||||
{{attachment:FreedomBox/Manual/HomeAssistant/homeassistant-setup-step-3.png|Setup - Step 3}}
|
||||
|
||||
{{attachment:FreedomBox/Manual/HomeAssistant/homeassistant-setup-step-4.png|Setup - Step 4}}
|
||||
|
||||
{{attachment:FreedomBox/Manual/HomeAssistant/homeassistant-setup-step-5.png|Setup - Step 5}}
|
||||
|
||||
Al añadir los adaptadores USB para que Home Assistant hable con los dispositivos de redes como Thread, !ZigBee, hay que reejecutar la operación en la app. Esta operación está en el menú desplegable Extras con un icono de tuercas en la página de la app de Home Assistant. También hay que reiniciar al quitar hardware. Si no, Home Assistant fallará al iniciarse.
|
||||
|
||||
=== Uso ===
|
||||
|
||||
Home Assistant proporciona unas aplicaciones para web y movil totalmente functionales. Simplemente ingresa:
|
||||
|
||||
{{attachment:FreedomBox/Manual/HomeAssistant/homeassistant-login.png|Login}}
|
||||
|
||||
{{attachment:FreedomBox/Manual/HomeAssistant/homeassistant-ui.png|Web UI}}
|
||||
|
||||
{{attachment:FreedomBox/Manual/HomeAssistant/homeassistant-app.png|Mobile App}}
|
||||
|
||||
=== Enlaces externos ===
|
||||
|
||||
* Sitio web: https://www.home-assistant.io
|
||||
* Código fuente de Home Assistant: https://github.com/home-assistant/core
|
||||
* Código fuente de la imágen del contenedor Home: https://github.com/home-assistant/docker
|
||||
|
||||
## END_INCLUDE
|
||||
|
||||
Volver a la [[es/FreedomBox/Features|descripción de Funcionalidades]] o a las páginas del [[es/FreedomBox/Manual|manual]].
|
||||
|
||||
|
||||
<<Include(es/FreedomBox/Portal)>>
|
||||
|
||||
----
|
||||
CategoryFreedomBox
|
||||
@ -24,6 +24,7 @@
|
||||
<<Include(FreedomBox/Manual/Email, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(FreedomBox/Manual/FeatherWiki, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(FreedomBox/Manual/GitWeb, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(FreedomBox/Manual/HomeAssistant, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(FreedomBox/Manual/Ikiwiki, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(FreedomBox/Manual/Infinoted, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(FreedomBox/Manual/Janus, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
|
||||
@ -8,6 +8,52 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f
|
||||
|
||||
The following are the release notes for each !FreedomBox version.
|
||||
|
||||
== FreedomBox 25.11 (2025-09-08) ==
|
||||
|
||||
=== Highlights ===
|
||||
|
||||
* email: Fix Thunderbird auto configuration failure
|
||||
* matrixsynapse, upgrades: Install select packages from unstable
|
||||
|
||||
=== Other Changes ===
|
||||
|
||||
* action_utils: Implement a utility to run a command as different user
|
||||
* actions, backup: Implement raw output for privileged daemon
|
||||
* actions, backups: Fix tests depending on sudo based actions
|
||||
* actions: Drop feature to run privileged action as another user
|
||||
* actions: Drop sudo based privileged actions
|
||||
* actions: Framework for capturing stdout/stderr in privileged daemon
|
||||
* actions: Simplify raw output code in privileged methods
|
||||
* backups: Trim translatable string
|
||||
* container: Add support for Trixie as stable distribution
|
||||
* container: Pass --nvram option to virsh undefine
|
||||
* d/control: Remove libpam-abl as a recommendation
|
||||
* diagnostics: Fix notification severity when skipping tests
|
||||
* dynamicdns: Handle showing errors from GnuDIP
|
||||
* gitweb: Don't use privileged action feature to run as different user
|
||||
* gitweb: Use pathlib API more
|
||||
* HACKING.md: Mention using virtual machines instead of containers
|
||||
* homeassistant: Fix typo in description
|
||||
* l10n: Fix a broken string in Russian translation
|
||||
* l10n: Fix broken Italian translation
|
||||
* l10n: Fix formatted strings for errors/exceptions
|
||||
* locale: Update translations for Bulgarian, Chinese (Simplified Han script), Czech, Dutch, French, German, Italian, Russian, Turkish, Ukrainian
|
||||
* Makefile, settings: Use full paths in pot files
|
||||
* package: Don't consider uninstalled packages as available
|
||||
* package: Refresh apt cache if sources list is newer
|
||||
* power: logind config to ignore laptop lid close
|
||||
* privileged: Don't isolate /var/tmp/ for privileged daemon
|
||||
* privileged_daemon: Introduce a command line client for the API
|
||||
* privileged_daemon: Log only to journal and not console
|
||||
* samba: Update client list
|
||||
* storage: Don't use privileged action feature to run as different user
|
||||
* syncthing: Update Android clients to Syncthing-Fork
|
||||
* tests: functional: Fix incorrect skipping of install tests
|
||||
* ui: Fix missing semicolon in JS file
|
||||
* upgrades: Don't allow needs-restart to restart privileged daemon
|
||||
* upgrades: Overhaul detection of distribution
|
||||
* web_server: Restart in development mode only for source code changes
|
||||
|
||||
== FreedomBox 25.10 (2025-08-18) ==
|
||||
|
||||
=== Highlights ===
|
||||
|
||||
@ -22,6 +22,7 @@
|
||||
<<Include(es/FreedomBox/Manual/ejabberd, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(es/FreedomBox/Manual/Email, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(es/FreedomBox/Manual/GitWeb, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(es/FreedomBox/Manual/HomeAssistant, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(es/FreedomBox/Manual/Ikiwiki, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(es/FreedomBox/Manual/Infinoted, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
<<Include(es/FreedomBox/Manual/Janus, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
|
||||
|
||||
BIN
doc/manual/es/images/homeassistant-app.png
Normal file
|
After Width: | Height: | Size: 66 KiB |
BIN
doc/manual/es/images/homeassistant-login.png
Normal file
|
After Width: | Height: | Size: 57 KiB |
BIN
doc/manual/es/images/homeassistant-setup-step-1.png
Normal file
|
After Width: | Height: | Size: 62 KiB |
BIN
doc/manual/es/images/homeassistant-setup-step-2.png
Normal file
|
After Width: | Height: | Size: 57 KiB |
BIN
doc/manual/es/images/homeassistant-setup-step-3.png
Normal file
|
After Width: | Height: | Size: 263 KiB |
BIN
doc/manual/es/images/homeassistant-setup-step-4.png
Normal file
|
After Width: | Height: | Size: 51 KiB |
BIN
doc/manual/es/images/homeassistant-setup-step-5.png
Normal file
|
After Width: | Height: | Size: 78 KiB |
BIN
doc/manual/es/images/homeassistant-ui.png
Normal file
|
After Width: | Height: | Size: 42 KiB |
BIN
doc/manual/es/images/homeassistant.png
Normal file
|
After Width: | Height: | Size: 12 KiB |