{
    "componentChunkName": "component---src-templates-markdown-doc-tsx",
    "path": "/2025.1.3/updates",
    "result": {"data":{"mdx":{"id":"e3a4f7c5-273f-52ff-a565-16fa24b0ba99","frontmatter":{"title":"","images":null},"body":"var _excluded = [\"components\"];\nfunction _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }\nfunction _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }\nfunction _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }\n/* @jsxRuntime classic */\n/* @jsx mdx */\n\nvar _frontmatter = {};\nvar layoutProps = {\n  _frontmatter: _frontmatter\n};\nvar MDXLayout = \"wrapper\";\nreturn function MDXContent(_ref) {\n  var components = _ref.components,\n    props = _objectWithoutProperties(_ref, _excluded);\n  return mdx(MDXLayout, _extends({}, layoutProps, props, {\n    components: components,\n    mdxType: \"MDXLayout\"\n  }), mdx(\"h1\", null, \"Updates\"), mdx(\"p\", null, \"This section will document the major changes in each Salvus version as well\\nas updating guides assisting in upgrading your Salvus installations.\"), mdx(\"p\", null, \"Before you download and install a new version of Salvus, please make sure\\nthat your python environment is still up-to-date.\"), mdx(\"h2\", null, \"Keeping the python environment up-to-date\"), mdx(\"p\", null, \"Sometimes, the python dependencies of newer Salvus versions change.\\nThis could either mean that we are requiring newer versions of some\\ndependencies and/or different packages.\"), mdx(\"p\", null, \"Assuming that you have set up a python environment \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"salvus\"), \" using \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"mamba\"), \",\\nwe strongly recommend obtaining the new dependencies from \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"mamba\"), \" as well,\\ninstead of installing them with \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"pip\"), \".\"), mdx(\"p\", null, \"In case you want to keep a backup of all current packages in your Salvus\\nenvironment, you can export the version number of all installed packages\\nusing\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-shell\"\n  }, \"mamba env export -n salvus >salvus_env_backup.yml\\n\")), mdx(\"p\", null, \"The following command downloads the current list of dependencies as\\nan environment yaml.\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-shell\"\n  }, \"curl https://docs.mondaic.com/environment-py311.yml -o environment.yml\\n\")), mdx(\"p\", null, \"You can then update the current environment with the following command.\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-shell\"\n  }, \"mamba env update -n salvus -f environment.yml\\n\")), mdx(\"p\", null, \"This will make sure that the environment will work with the new version\\nof Salvus and that no additional packages will be installed during the\\nupgrade step.\"), mdx(\"h2\", null, \"Upgrading Salvus\"), mdx(\"p\", null, \"There are a few different ways to upgrade your Salvus installation.\"), mdx(\"h3\", null, \"Built-in Commands\"), mdx(\"p\", null, \"If you already have a running Salvus installation you can update in two ways:\"), mdx(\"p\", null, \"Update the local Python installation:\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-shell\"\n  }, \"salvus-cli upgrade --help\\n\")), mdx(\"p\", null, \"Update the Salvus installation of a remote site:\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-shell\"\n  }, \"salvus-cli upgrade-site --help\\n\")), mdx(\"p\", null, \"In both cases an interactive wizard will guide you along the way.\"), mdx(\"h3\", null, \"Running the Downloader Again and Manually Upgrading\"), mdx(\"p\", null, \"Running the downloader again will ensure all local files are updated to the\\nlatest available version. It will download anything that\\nmisses/has been updated and keep your folder structure in consistent state.\\nYou then might have to invoke \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"pip install ...\"), \" again and reinitialize any\\nsites.\"));\n}\n;\nMDXContent.isMDXComponent = true;"},"site":{"siteMetadata":{"salvusDocVersions":{"current":"2026.5.0"}}}},"pageContext":{"id":"e3a4f7c5-273f-52ff-a565-16fa24b0ba99"}},
    "staticQueryHashes": ["1756726491","1865182279","3419370438","3597190305","4112489441","519097329"]}