diff --git a/README.md b/README.md index 94483350a..542fde3dd 100644 --- a/README.md +++ b/README.md @@ -199,6 +199,12 @@ For efficient searches we recommend to install `pt` ([the platinum searcher][]). manually. 3. Launch Emacs. Spacemacs will automatically install the packages it requires. + If you get an error regarding package downloads then you may try to disable + HTTPS protocol by starting Emacs with + + ```sh + emacs --insecure + ``` 4. Restart Emacs to complete the installation. diff --git a/doc/FAQ.org b/doc/FAQ.org index f76545aed..46bb3c43c 100644 --- a/doc/FAQ.org +++ b/doc/FAQ.org @@ -6,6 +6,7 @@ - [[Which version of Spacemacs am I running?][Which version of Spacemacs am I running?]] - [[What is the official pronunciation of Spacemacs?][What is the official pronunciation of Spacemacs?]] - [[Why are packages installed with =package-install= automatically deleted by Spacemacs when it boots?][Why are packages installed with =package-install= automatically deleted by Spacemacs when it boots?]] + - [[How to fix package download errors when installing Spacemacs ?][How to fix package download errors when installing Spacemacs ?]] - [[The Spacemacs banner is ugly, what should I do?][The Spacemacs banner is ugly, what should I do?]] - [[The powerline separators are ugly, how can I fix them?][The powerline separators are ugly, how can I fix them?]] - [[The powerline separators have no anti-aliasing, what can I do?][The powerline separators have no anti-aliasing, what can I do?]] @@ -53,6 +54,14 @@ To declare new packages you have to create a new configuration layer or add the package name to the variable =dotspacemacs-additonal-packages= of your dotfile, see the [[file:QUICK_START.org][quick start guide]] for more info. +** How to fix package download errors when installing Spacemacs ? +Since 0.105.0 HTTPS protocol is used by default to download packages. If your +environment does not allow HTTPS to reach ELPA repositories then you can start +Emacs with the =--insecure= argument for force the usage of HTTP non secured +protocol. +Then you can set the variable =dotspacemacs-elpa-https= to =nil= in your +dotfile to remove the need to start Emacs with =--insecure== argument. + ** The Spacemacs banner is ugly, what should I do? Install the default font supported by Spacemacs or choose a fixed width font. More information in the font section of the [[file:DOCUMENTATION.org][documentation]].