# Upgrade instructions

**URL:** <https://racket.discourse.group/t/upgrade-instructions/1655>\
**Category:** Questions & Answers\
**Created:** [January 21, 2023, 8:31pm UTC](https://racket.discourse.group/t/upgrade-instructions/1655 "2023-01-21T20:31:20Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![hendrikboom3](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/hendrikboom3/32/2748_2.png) [@hendrikboom3](https://racket.discourse.group/u/hendrikboom3)\
**Post date:** [January 21, 2023, 8:31pm UTC](https://racket.discourse.group/t/upgrade-instructions/1655/1 "2023-01-21T20:31:20Z")

</div>

The page [Racket v8.7](https://blog.racket-lang.org/2022/11/racket-v8-7.html) contains links to [https://download.racket-lang.org/](https://download.racket-lang.org/) . At least for the Linux version that page explains how to install Racket 8.7. Perhaps it should also explain how to upgrade to 8.7 from a previous release?

-- hendrik

---

<div class="post-metadata">

**Author:** ![JohnSnow](https://avatars.discourse-cdn.com/v4/letter/j/74df32/32.png) [@JohnSnow](https://racket.discourse.group/u/JohnSnow)\
**Post date:** [January 21, 2023, 9:07pm UTC](https://racket.discourse.group/t/upgrade-instructions/1655/2 "2023-01-21T21:07:23Z")

</div>

When you use the `.sh` installer, there is this message:

```scheme
Do you want a Unix-style distribution?
  In this distribution mode files go into different directories according
  to Unix conventions. A "racket-uninstall" script will be generated
  to be used when you want to remove the installation. If you say 'no',
  the whole Racket directory is kept in a single installation directory
  (movable and erasable), possibly with external links into it -- this is
  often more convenient, especially if you want to install multiple
  versions or keep it in your home directory.

```

ps: I don't think anyone can remember this message exists when they try to upgrade/uninstall racket 4 months after installation. I just stopped using the `.sh` install for this reason.

You can try the `racket-uninstall`, or nuke the `racket/` directory, then install the new version.

You probably also want to scan invalid racket symbolic links under `~/bin`? `~/local/bin/`? `~/.bin`?

---

<div class="post-metadata">

**Author:** ![hendrikboom3](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/hendrikboom3/32/2748_2.png) [@hendrikboom3](https://racket.discourse.group/u/hendrikboom3)\
**Post date:** [January 22, 2023, 1:53pm UTC](https://racket.discourse.group/t/upgrade-instructions/1655/3 "2023-01-22T13:53:06Z")

</div>

Indeed. That's how to do it.  
Easier for me, because I just told it to stash everything into /usr/local/racket, and set my PATH to include those sibdirectories.  
My point was that the online documentation whould be better, and that upgrade instructions should be found near the installtion instructions for a new release.

-- hendrik

---

<div class="post-metadata">

**Author:** ![taeknibunadur](https://avatars.discourse-cdn.com/v4/letter/t/3ab097/32.png) [@taeknibunadur](https://racket.discourse.group/u/taeknibunadur)\
**Post date:** [November 17, 2023, 9:09am UTC](https://racket.discourse.group/t/upgrade-instructions/1655/4 "2023-11-17T09:09:07Z")

</div>

Thank you. I think I know what to do now.
