{"_id":"59232c83c2cabf19005d5f53","user":"54e7ff93c1c5e90d0048bd92","parentDoc":null,"project":"54e7fca9e6e77d1900ed11f0","__v":0,"category":{"_id":"58fe142d180afa25006c7975","version":"58fe142d180afa25006c7974","project":"54e7fca9e6e77d1900ed11f0","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-02-21T03:34:02.028Z","from_sync":false,"order":0,"slug":"documentation","title":"Documentation"},"version":{"_id":"58fe142d180afa25006c7974","project":"54e7fca9e6e77d1900ed11f0","__v":2,"createdAt":"2017-04-24T15:05:17.571Z","releaseDate":"2017-04-24T15:05:17.571Z","categories":["58fe142d180afa25006c7975","58fe142d180afa25006c7976","58fe142d180afa25006c7977","58fe142d180afa25006c7978","591f725ffc05d30f00488267"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.1.0","version":"1.1"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-05-22T18:22:59.662Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":4,"body":"This guide is for upgrading PufferPanel from v1.0 to v1.1. If your PufferPanel install is already at v1.1, please see the [Updating PufferPanel](doc:updating-pufferpanel) documentation instead.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Updating Dependencies\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"PHP 7 Required\",\n  \"body\": \"PufferPanel now requires PHP 7 to function. Please make sure you are using PHP 7 by running `php -v`.\\n\\nIf you do not have PHP 7, please follow the instructions below for your distribution of Linux.\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"PHP 7 should already be installed on Ubuntu 16.04\",\n      \"language\": \"text\",\n      \"name\": \"Ubuntu 16.04\"\n    },\n    {\n      \"code\": \"# This adds the https://launchpad.net/~ondrej/+archive/ubuntu/php/ repo in order to install php7\\nsudo add-apt-repository ppa:ondrej/php\\n\\n# If you currently have apache2 installed you will not be able to use nginx as well. Please plan accordingly.\\nsudo apt update\\nsudo apt install php-fpm php-cli php-curl php-mysql\",\n      \"language\": \"shell\",\n      \"name\": \"Ubuntu 14.04\"\n    },\n    {\n      \"code\": \"# This adds the https://packages.sury.org/php/ repo in order to install php7\\nsudo apt -y install apt-transport-https lsb-release ca-certificates wget\\nsudo wget https://packages.sury.org/php/apt.gpg -O - | sudo apt-key add -\\nsudo echo \\\"deb https://packages.sury.org/php/ $(lsb_release -sc) main\\\" > /etc/apt/sources.list.d/php.list\\n\\n# If you currently have apache2 installed you will not be able to use nginx as well. Please plan accordingly.\\nsudo apt update\\nsudo apt install -y php-fpm php-cli php-curl php-mysql\",\n      \"language\": \"shell\",\n      \"name\": \"Debian 8\"\n    },\n    {\n      \"code\": \"# This installs the epel and remi repos for php7 support\\nsudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm\\nsudo yum install http://rpms.remirepo.net/enterprise/remi-release-7.rpm\\nsudo yum install yum-utils\\nsudo yum-config-manager --enable remi-php71\\n\\n# If you currently have apache2 installed you will not be able to use nginx as well. Please plan accordingly.\\nsudo yum update\\nsudo yum install php-fpm php-common php-cli php-pdo php-mysqlnd\",\n      \"language\": \"shell\",\n      \"name\": \"CentOS 7\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Updating nginx Configuration\"\n}\n[/block]\nWe need to update nginx to use PHP 7. Please run the following commands to automatically update pufferpanel.conf\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"phpSocket=$(grep \\\"^listen[| ]\\\\?=[| ]\\\" /etc/php/*/fpm/pool.d/www.conf 2>/dev/null | awk -F'[=&]' '{print $2}' | sed -e 's/ //')\\n\\nsudo sed -i \\\"s#fastcgi_pass .*;#fastcgi_pass unix:/var${phpSocket};#\\\" /etc/nginx/sites-available/pufferpanel.conf\\n\\nsudo service nginx restart\",\n      \"language\": \"shell\",\n      \"name\": \"Ubuntu/Debian\"\n    },\n    {\n      \"code\": \"phpSocket=$(grep \\\"^listen[| ]\\\\?=[| ]\\\" /etc/php-fpm.d/www.conf 2>/dev/null | awk -F'[=&]' '{print $2}' | sed -e 's/ //')\\n\\nsudo sed -i \\\"s#fastcgi_pass .*;#fastcgi_pass ${phpSocket};#\\\" /etc/nginx/conf.d/pufferpanel.conf\\n\\nsudo systemctl restart nginx\",\n      \"language\": \"shell\",\n      \"name\": \"CentOS 7\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Upgrading PufferPanel\"\n}\n[/block]\n**Please make sure your PufferPanel installation is already at v1.0.3.** \nIf it is not, please follow the documentation [here](https://www.pufferpanel.com/v1.0/docs/updating-pufferpanel) to update to v1.0.3 first.\n\n**You SHOULD NOT run ```./pufferpanel upgrade``` if your panel is already at v1.1.0 or any v1.1.x version.**\n\nTo upgrade PufferPanel to v1.1, please run the following commands, making sure to prefix the commands with `sudo` or run them as the root user:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"cd /srv\\ncurl -L -o pufferpanel.tar.gz https://git.io/vH8Da\\ntar -xf pufferpanel.tar.gz\\n### STOP HERE if your PufferPanel install is already at v1.1.0, v1.1.1, or v1.1.2\\ncd pufferpanel\\n./pufferpanel upgrade\",\n      \"language\": \"shell\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Updating pufferd\"\n}\n[/block]\nPlease follow [this page](doc:updating-pufferd) for instructions on how to update pufferd.\n\nIf you have not yet migrated to pufferd from Scales, please follow [these instructions](doc:migrating-to-pufferd) on how to migrate to pufferd.","excerpt":"How to upgrade PufferPanel","slug":"upgrading-pufferpanel","type":"basic","title":"Upgrading PufferPanel"}

Upgrading PufferPanel

How to upgrade PufferPanel

This guide is for upgrading PufferPanel from v1.0 to v1.1. If your PufferPanel install is already at v1.1, please see the [Updating PufferPanel](doc:updating-pufferpanel) documentation instead. [block:api-header] { "type": "basic", "title": "Updating Dependencies" } [/block] [block:callout] { "type": "warning", "title": "PHP 7 Required", "body": "PufferPanel now requires PHP 7 to function. Please make sure you are using PHP 7 by running `php -v`.\n\nIf you do not have PHP 7, please follow the instructions below for your distribution of Linux." } [/block] [block:code] { "codes": [ { "code": "PHP 7 should already be installed on Ubuntu 16.04", "language": "text", "name": "Ubuntu 16.04" }, { "code": "# This adds the https://launchpad.net/~ondrej/+archive/ubuntu/php/ repo in order to install php7\nsudo add-apt-repository ppa:ondrej/php\n\n# If you currently have apache2 installed you will not be able to use nginx as well. Please plan accordingly.\nsudo apt update\nsudo apt install php-fpm php-cli php-curl php-mysql", "language": "shell", "name": "Ubuntu 14.04" }, { "code": "# This adds the https://packages.sury.org/php/ repo in order to install php7\nsudo apt -y install apt-transport-https lsb-release ca-certificates wget\nsudo wget https://packages.sury.org/php/apt.gpg -O - | sudo apt-key add -\nsudo echo \"deb https://packages.sury.org/php/ $(lsb_release -sc) main\" > /etc/apt/sources.list.d/php.list\n\n# If you currently have apache2 installed you will not be able to use nginx as well. Please plan accordingly.\nsudo apt update\nsudo apt install -y php-fpm php-cli php-curl php-mysql", "language": "shell", "name": "Debian 8" }, { "code": "# This installs the epel and remi repos for php7 support\nsudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm\nsudo yum install http://rpms.remirepo.net/enterprise/remi-release-7.rpm\nsudo yum install yum-utils\nsudo yum-config-manager --enable remi-php71\n\n# If you currently have apache2 installed you will not be able to use nginx as well. Please plan accordingly.\nsudo yum update\nsudo yum install php-fpm php-common php-cli php-pdo php-mysqlnd", "language": "shell", "name": "CentOS 7" } ] } [/block] [block:api-header] { "title": "Updating nginx Configuration" } [/block] We need to update nginx to use PHP 7. Please run the following commands to automatically update pufferpanel.conf [block:code] { "codes": [ { "code": "phpSocket=$(grep \"^listen[| ]\\?=[| ]\" /etc/php/*/fpm/pool.d/www.conf 2>/dev/null | awk -F'[=&]' '{print $2}' | sed -e 's/ //')\n\nsudo sed -i \"s#fastcgi_pass .*;#fastcgi_pass unix:/var${phpSocket};#\" /etc/nginx/sites-available/pufferpanel.conf\n\nsudo service nginx restart", "language": "shell", "name": "Ubuntu/Debian" }, { "code": "phpSocket=$(grep \"^listen[| ]\\?=[| ]\" /etc/php-fpm.d/www.conf 2>/dev/null | awk -F'[=&]' '{print $2}' | sed -e 's/ //')\n\nsudo sed -i \"s#fastcgi_pass .*;#fastcgi_pass ${phpSocket};#\" /etc/nginx/conf.d/pufferpanel.conf\n\nsudo systemctl restart nginx", "language": "shell", "name": "CentOS 7" } ] } [/block] [block:api-header] { "title": "Upgrading PufferPanel" } [/block] **Please make sure your PufferPanel installation is already at v1.0.3.** If it is not, please follow the documentation [here](https://www.pufferpanel.com/v1.0/docs/updating-pufferpanel) to update to v1.0.3 first. **You SHOULD NOT run ```./pufferpanel upgrade``` if your panel is already at v1.1.0 or any v1.1.x version.** To upgrade PufferPanel to v1.1, please run the following commands, making sure to prefix the commands with `sudo` or run them as the root user: [block:code] { "codes": [ { "code": "cd /srv\ncurl -L -o pufferpanel.tar.gz https://git.io/vH8Da\ntar -xf pufferpanel.tar.gz\n### STOP HERE if your PufferPanel install is already at v1.1.0, v1.1.1, or v1.1.2\ncd pufferpanel\n./pufferpanel upgrade", "language": "shell" } ] } [/block] [block:api-header] { "type": "basic", "title": "Updating pufferd" } [/block] Please follow [this page](doc:updating-pufferd) for instructions on how to update pufferd. If you have not yet migrated to pufferd from Scales, please follow [these instructions](doc:migrating-to-pufferd) on how to migrate to pufferd.