{"result":{"depiction_url":null,"edges":{"hasreference":{"objects":[{"created":"2026-10-07T11:13:50Z","object_id":{"id":1530,"is_a":["text","documentation","reference"],"name":"doc_reference_installation_requirements","title":{"_type":"trans","tr":{"en":"Installation requirements"}},"uri":"https:\/\/zotonic.com\/id\/1530"},"seq":1},{"created":"2026-10-07T11:13:50Z","object_id":{"id":3075,"is_a":["text","documentation","adminguide"],"name":"admin_upgrade","title":{"_type":"trans","tr":{"en":"Plan and apply an upgrade"}},"uri":"https:\/\/zotonic.com\/id\/3075"},"seq":2}],"predicate":{"id":2774,"is_a":["meta","predicate"],"name":"hasreference","title":{"_type":"trans","tr":{"en":"Documentation reference"}},"uri":"https:\/\/zotonic.com\/id\/hasreference"}},"references":{"objects":[{"created":"2020-05-30T05:47:33Z","object_id":{"id":1411,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_docker","title":{"_type":"trans","tr":{"en":"Install with Docker or Podman"}},"uri":"https:\/\/zotonic.com\/id\/1411"},"seq":1000000},{"created":"2020-05-30T05:47:33Z","object_id":{"id":1752,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_acl_user_groups","title":"mod_acl_user_groups","uri":"https:\/\/zotonic.com\/id\/1752"},"seq":1000000},{"created":"2020-05-30T05:47:33Z","object_id":{"id":1481,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_deployment_env","title":{"_type":"trans","tr":{"en":"Keep development and production settings distinct"}},"uri":"https:\/\/zotonic.com\/id\/1481"},"seq":1000000},{"created":"2020-05-30T05:47:33Z","object_id":{"id":1720,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_export","title":"mod_export","uri":"https:\/\/zotonic.com\/id\/1720"},"seq":1000000},{"created":"2020-05-30T05:47:33Z","object_id":{"id":1753,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_ssl_ca","title":"mod_ssl_ca","uri":"https:\/\/zotonic.com\/id\/1753"},"seq":1000000},{"created":"2020-05-30T05:47:33Z","object_id":{"id":1754,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_ssl_letsencrypt","title":"mod_ssl_letsencrypt","uri":"https:\/\/zotonic.com\/id\/1754"},"seq":1000000},{"created":"2020-05-30T05:47:33Z","object_id":{"id":1482,"is_a":["text","documentation","reference"],"name":"doc_developerguide_configuration_port_ssl_configuration","title":"Port configurations","uri":"https:\/\/zotonic.com\/id\/1482"},"seq":1000000},{"created":"2020-05-30T05:47:33Z","object_id":{"id":1755,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_deployment_https","title":{"_type":"trans","tr":{"en":"Configure hostnames and HTTPS"}},"uri":"https:\/\/zotonic.com\/id\/1755"},"seq":1000000},{"created":"2020-05-30T05:47:33Z","object_id":{"id":1454,"is_a":["text","documentation","reference"],"name":"doc_developerguide_configuration_zotonic_configuration","title":"Global configuration","uri":"https:\/\/zotonic.com\/id\/1454"},"seq":1000000},{"created":"2020-05-30T05:47:33Z","object_id":{"id":1302,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_server_browser_interaction","title":{"_type":"trans","tr":{"en":"Handle a browser event with a wire"}},"uri":"https:\/\/zotonic.com\/id\/1302"},"seq":1000000},{"created":"2020-05-30T05:47:33Z","object_id":{"id":1301,"is_a":["text","documentation","reference","template_scomp"],"name":"doc_template_scomp_scomp_script","title":"script","uri":"https:\/\/zotonic.com\/id\/1301"},"seq":1000000},{"created":"2020-05-30T05:47:33Z","object_id":{"id":1555,"is_a":["text","documentation","reference","controller"],"name":"doc_controller_controller_file","title":"controller_file","uri":"https:\/\/zotonic.com\/id\/1555"},"seq":1000000},{"created":"2020-05-30T05:47:33Z","object_id":{"id":1556,"is_a":["text","documentation","reference","controller"],"name":"doc_controller_controller_file_id","title":"controller_file_id","uri":"https:\/\/zotonic.com\/id\/1556"},"seq":1000000},{"created":"2020-05-30T05:47:33Z","object_id":{"id":1353,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_modules","title":{"_type":"trans","tr":{"en":"Create a reusable module"}},"uri":"https:\/\/zotonic.com\/id\/1353"},"seq":1000000},{"created":"2022-02-02T20:18:50Z","object_id":{"id":1640,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_logging","title":{"_type":"trans","tr":{"en":"Write logs that explain an operation"}},"uri":"https:\/\/zotonic.com\/id\/1640"},"seq":1000000}],"predicate":{"id":332,"is_a":["meta","predicate"],"name":"references","title":{"_type":"trans","tr":{"en":"References"}},"uri":"https:\/\/zotonic.com\/id\/references"}},"refers":{"objects":[{"created":"2026-09-20T16:12:44Z","object_id":{"id":1720,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_export","title":"mod_export","uri":"https:\/\/zotonic.com\/id\/1720"},"seq":1000000},{"created":"2026-09-20T16:12:44Z","object_id":{"id":1752,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_acl_user_groups","title":"mod_acl_user_groups","uri":"https:\/\/zotonic.com\/id\/1752"},"seq":1000000},{"created":"2026-09-20T16:12:44Z","object_id":{"id":1753,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_ssl_ca","title":"mod_ssl_ca","uri":"https:\/\/zotonic.com\/id\/1753"},"seq":1000000},{"created":"2026-09-20T16:12:44Z","object_id":{"id":1754,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_ssl_letsencrypt","title":"mod_ssl_letsencrypt","uri":"https:\/\/zotonic.com\/id\/1754"},"seq":1000000}],"predicate":{"id":2409,"is_a":["meta","predicate"],"name":"refers","title":{"_type":"trans","tr":{"en":"Refers"}},"uri":"https:\/\/zotonic.com\/id\/refers"}},"relation":{"objects":[{"created":"2022-02-02T20:18:50Z","object_id":{"id":1580,"is_a":["text","documentation","cookbook"],"name":"doc_cookbook_logstash","title":{"_type":"trans","tr":{"en":"Send structured logs to Logstash"}},"uri":"https:\/\/zotonic.com\/id\/1580"},"seq":1000000}],"predicate":{"id":303,"is_a":["meta","predicate"],"name":"relation","title":{"_type":"trans","tr":{"nl":"Relatie","en":"Relation"}},"uri":"http:\/\/purl.org\/dc\/terms\/relation"}},"subject":{"objects":[{"created":"2026-09-20T16:10:29Z","object_id":{"id":2559,"is_a":["categorization","keyword","keyword_information_type"],"name":"zotonic_topic_migration_guide","title":"Migration guide","uri":"https:\/\/zotonic.com\/id\/2559"},"seq":1},{"created":"2026-09-20T16:10:33Z","object_id":{"id":2564,"is_a":["categorization","keyword","keyword_audience"],"name":"zotonic_topic_backend_developer","title":"Backend developer","uri":"https:\/\/zotonic.com\/id\/2564"},"seq":2},{"created":"2026-09-20T16:11:04Z","object_id":{"id":2658,"is_a":["categorization","keyword","keyword_task"],"name":"zotonic_topic_migrate","title":"Migrate","uri":"https:\/\/zotonic.com\/id\/2658"},"seq":3},{"created":"2026-10-07T11:13:50Z","object_id":{"id":2689,"is_a":["categorization","keyword","keyword_quality"],"name":"zotonic_topic_reliability","title":"Reliability","uri":"https:\/\/zotonic.com\/id\/2689"},"seq":4},{"created":"2026-09-20T16:10:34Z","object_id":{"id":2563,"is_a":["categorization","keyword","keyword_audience"],"name":"zotonic_topic_frontend_developer","title":"Frontend developer","uri":"https:\/\/zotonic.com\/id\/2563"},"seq":5},{"created":"2026-09-20T16:10:52Z","object_id":{"id":2691,"is_a":["categorization","keyword","keyword_quality"],"name":"zotonic_topic_maintainability","title":"Maintainability","uri":"https:\/\/zotonic.com\/id\/2691"},"seq":6}],"predicate":{"id":308,"is_a":["meta","predicate"],"name":"subject","title":{"_type":"trans","tr":{"en":"Keyword"}},"uri":"http:\/\/purl.org\/dc\/elements\/1.1\/subject"}}},"id":1455,"is_a":["text","documentation","developerguide"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1455"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"doc_developerguide_upgrading","page_url":{"en":"https:\/\/zotonic.com\/docs\/1455\/upgrade-notes","x-default":"https:\/\/zotonic.com\/docs\/1455\/upgrade-notes"},"preview_url":null,"resource":{"version":36,"pivot_location_lat":null,"title":{"_type":"trans","tr":{"en":"Upgrade notes"}},"is_authoritative":true,"body":{"_type":"trans","tr":{"en":"
\n

These notes list the most important changes between Zotonic versions. Please read these notes carefully when upgrading to a new major Zotonic version.<\/p>\n

\n

Upgrading from 0.x to 1.0<\/h2>\n

Before upgrading to 1.0, be sure to check the upgrade notes for the latest 0.x version, especially if you are upgrading from before 0.12. See the upgrade notes on 0.x<\/a> for more information.<\/p>\n

\n

Erlang\/OTP<\/h3>\n

This is a historical migration guide from Zotonic 0.x. For current development use Erlang\/OTP 28 and the current installation requirements; do not interpret old-version examples below as installation advice.<\/p>\n

Zotonic modules are now separately published as packages to Hex.pm<\/a>, which allows you to build your own Zotonic distribution and to have each of your sites depend on the Zotonic modules (and other Erlang packages) it needs.<\/p>\n

This was done by restructuring Zotonic into an umbrella application<\/a>. The src\/<\/span><\/code> directory was moved to new zotonic_core<\/span><\/code> app.<\/p>\n

Before:<\/p>\n

\n
\n
-<\/span>include_lib<\/span>(<\/span>"zotonic.hrl"<\/span>).<\/span>\n<\/pre>\n<\/div>\n<\/div>\n
After:<\/p>\n
\n
\n
-<\/span>include_lib<\/span>(<\/span>"zotonic_core\/include\/zotonic.hrl"<\/span>).<\/span>\n<\/pre>\n<\/div>\n<\/div>\n
The HTTP and SMTP listeners were moved to a new zotonic_listen_http<\/span><\/code> and zotonic_listen_smtp<\/span><\/code> app respectively.<\/p>\n
A zotonic_launcher<\/span><\/code> app was introduced for starting Zotonic.<\/p>\n
All built-in modules, the testsandbox and the status sites are now to be found in the apps\/<\/span><\/code> directory.<\/p>\n<\/div>\n
\n
Docker<\/h3>\n
Only the zotonic\/zotonic-dev<\/a> image is now available and automatically updated.<\/p>\n
We have decided to drop the other Docker images as in practice everybody was creating their own production images anyway.<\/p>\n
All files used by the Docker container are now placed in the docker-data<\/span><\/code> directory.<\/p>\n
See for more information Docker<\/span><\/a>.<\/p>\n<\/div>\n
\n
Sites and modules are now OTP apps<\/h3>\n
Both sites and modules now follow the standard OTP directory structure<\/a>, which means all Erlang files should reside in src\/<\/span><\/code> and all other files (templates, dispatch rules etc.) in priv<\/span><\/code>\/.<\/p>\n
Before:<\/p>\n
\n
\n
yoursite<\/span>\/<\/span>\n    models<\/span>\/<\/span>\n        m_some_model<\/span>.<\/span>erl<\/span>\n    templates<\/span>\/<\/span>\n        some_template<\/span>.<\/span>tpl<\/span>\n    yoursite<\/span>.<\/span>erl<\/span>\n    config<\/span>\n    ...<\/span>\n<\/pre>\n<\/div>\n<\/div>\n
After:<\/p>\n
\n
\n
yoursite<\/span>\/<\/span>\n    priv<\/span>\/<\/span>\n        zotonic_site<\/span>.<\/span>config<\/span>\n        templates<\/span>\/<\/span>some_template<\/span>.<\/span>tpl<\/span>\n        ...<\/span>\n    src<\/span>\/<\/span>\n        models<\/span>\/<\/span>m_some_model<\/span>.<\/span>erl<\/span>\n        yoursite<\/span>.<\/span>erl<\/span>\n        yoursite<\/span>.<\/span>app<\/span>.<\/span>src<\/span>\n        ...<\/span>\n    rebar<\/span>.<\/span>config<\/span>\n<\/pre>\n<\/div>\n<\/div>\n
The user_sites_dir<\/span><\/code> and user_modules_dir<\/span><\/code> configurations have been removed. The default location for sites and modules is now the apps_user<\/span><\/code> directory. With the ZOTONIC_APPS<\/span><\/code> environment variable you can define an additional source directory outside the Zotonic umbrella apps<\/span><\/code> directory.<\/p>\n
To upgrade, move your user\/modules<\/span><\/code> and user\/sites<\/span><\/code> applications to the apps_user<\/span><\/code> directory.<\/p>\n
Also ensure that module directories are renamed, for example mod_mymod<\/code> becomes:<\/p>\n
zotonic_mod_mymod
    src\/mod_mymod.erl
    src\/zotonic_mod_mymod.app.src<\/pre>\n<\/div>\n
\n
Sites do not need to be renamed, though they must<\/em> have the priv\/zotonic_site.config<\/code> file.<\/p>\n
Resources<\/h3>\n
All resources are now maps<\/em> with binary<\/em> keys. Use of the previous 0.x proplists is deprecated, the fetch routines will always return maps, the update routines will convert property lists to maps before updating.<\/p>\n
The name_to_id_check\/2<\/span><\/code> functions were removed from m_category<\/span><\/code>, m_predicate<\/span><\/code> and m_rsc<\/span><\/code>.<\/p>\n
Before:<\/p>\n
\n
\n
Id<\/span> =<\/span> m_rsc<\/span>:<\/span>name_to_id_check<\/span>(<\/span>Value<\/span>,<\/span> Context<\/span>).<\/span>\n<\/pre>\n<\/div>\n<\/div>\n
After:<\/p>\n
\n
\n
{<\/span>ok<\/span>,<\/span> Id<\/span>}<\/span> =<\/span> m_rsc<\/span>:<\/span>name_to_id<\/span>(<\/span>Value<\/span>,<\/span> Context<\/span>).<\/span>\n<\/pre>\n<\/div>\n<\/div>\n
Inserting or deleting an edge no longer modifies the last modified and modifier properties of the edge’s subject resource.<\/p>\n
There are extra access controls on rsc properties. The privacy<\/span><\/code> property controls what is visible for whom.<\/p>\n
The function m_rsc:get_visible\/2<\/span><\/code> has been removed. The function m_rsc:get\/2<\/span><\/code> now checks on visibility of properties. To fetch all properties, either use m_rsc:get_raw\/2<\/span><\/code> or call m_rsc:get\/2<\/span><\/code> as a administrator level user.<\/p>\n<\/div>\n
\n
Media<\/h3>\n
The medium record is now a map<\/em> with binary<\/em> keys. Use of the previous 0.x proplists is deprecated, the fetch routines will always return maps, the update routines will convert property lists to maps before updating.<\/p>\n<\/div>\n
\n
ACL<\/h3>\n
mod_acl_adminonly was replaced by mod_acl_user_groups<\/span><\/a>. To create users that have access to the admin, add them to the ‘Managers’ user group.<\/p>\n
The visible_for<\/span><\/code> property semantics and the the acl_can_see<\/span><\/code> notification were removed. You can get similar functionality by adding users to user and collaboration groups. These are provided by mod_acl_user_groups. The visible_for<\/span><\/code> rsc<\/span><\/code> table property has been kept for BC. So if you’re using mod_acl_adminonly, mod_acl_simple_roles or a custom ACL module you can still rely on the property.<\/p>\n
The acl_rsc_update_check<\/span><\/code> notification was removed.<\/p>\n<\/div>\n
\n
Authentication<\/h3>\n
All auth notifications values were converted to records.<\/p>\n
Before:<\/p>\n
\n
\n
observe_auth_logon<\/span>(<\/span>auth_logon<\/span>,<\/span> Context<\/span>,<\/span> _<\/span>Context<\/span>)<\/span> -><\/span>\n<\/pre>\n<\/div>\n<\/div>\n
After:<\/p>\n
\n
\n
observe_auth_logon<\/span>(<\/span>#auth_logon<\/span>{},<\/span> Context<\/span>,<\/span> _<\/span>Context<\/span>)<\/span> -><\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n
\n
Configuration<\/h3>\n
Port configuration environment variables<\/span><\/a> were changed.<\/p>\n
Before:<\/p>\n
\n
\n
ZOTONIC_PORT<\/span>=<\/span>80<\/span> ZOTONIC_SSL_PORT<\/span>=<\/span>443<\/span> bin\/zotonic start\n<\/pre>\n<\/div>\n<\/div>\n
After:<\/p>\n
\n
\n
ZOTONIC_LISTEN_PORT<\/span>=<\/span>80<\/span> ZOTONIC_SSL_LISTEN_PORT<\/span>=<\/span>443<\/span> bin\/zotonic start\n<\/pre>\n<\/div>\n<\/div>\n
Black\/white-lists are now called block\/allow-lists.<\/p>\n