# Fix an image 404 with storage:link

> storage:link maps public/storage to storage/app/public. Laravel Cloud does not keep that symlink.

- URL: https://laravel-vuejs.space/php-artisan-storage-link-vue
- Author: Anass Ez-zouaine (https://laravel-vuejs.space/author/anass-ez-zouaine)
- Published: 2026-10-11
- Topics: Laravel, VueJs, Setup

People searching “Laravel storage link Vue” save a file and the `<img>` is 404. The public disk writes `storage/app/public`. The browser asks for `/storage/...`. The link connects them. The [upload guide](https://laravel-vuejs.space/laravel-vue-file-upload) stores the file. The [deploy guide](https://laravel-vuejs.space/deploy-laravel-vue) says to skip this command on Laravel Cloud.

> **TL;DR**
>
> -   storage:link maps public/storage to storage/app/public.
> -   Laravel Cloud does not keep that symlink.
> -   Do not commit `public/storage` as a real directory of uploads.
> -   Do not run this on Laravel Cloud and expect the next deploy to keep it.
>
> **Who it's for:** Laravel + Vue developers
>
> **Applies to:** Laravel 13 · Vue 3

## The fix

```shell
php artisan storage:link
```

That creates `public/storage`. Run it once per machine that serves the public disk. The Vue page prints a root-relative URL:

```vue
<img v-if="post.cover_url" :src="post.cover_url" alt="" />
```

`cover_url` is something like `/storage/covers/a.jpg`, from `Storage::url($path)` when the disk is `public`.

## What to avoid

> **Gotcha**
>
> Do not commit `public/storage` as a real directory of uploads. The symlink is local. Do not run this on Laravel Cloud and expect the next deploy to keep it. Cloud’s disk resets. User uploads there belong in the bucket the deploy guide points at.

## FAQ

**Q: How do I fix an image 404 with storage:link?**

storage:link maps public/storage to storage/app/public. Laravel Cloud does not keep that symlink.

**Q: What goes wrong with Laravel storage link Vue?**

Many developers save a file and the `<img>` is 404. Do not commit `public/storage` as a real directory of uploads.